Common Git Errors and Solutions

1. fatal: not a git repository

fatal: not a git repository (or any of the parent directories): .git

Cause

The directory is not under Git version control (git init was not run, or the .git folder was deleted).

Solution

Initialize the repository with git init.

2. error: src refspec main does not match any

error: src refspec main does not match any

Cause

You ran git push origin main when the main branch did not exist.

Solution

git branch -M main # Rename the branch to main
git add . # Stage files
git commit -m “Initial commit” # Make the first commit
git push -u origin main # Push to GitHub

3. fatal: ‘origin’ does not appear to be a git repository

fatal: ‘origin’ does not appear to be a git repository

Cause

The remote (origin) is not configured.

Solution

Create a repository on GitHub

Link it to your local machine

git remote add origin https://github.com/ユーザー名/リポジトリ名.git
git push -u origin main

Key Points

git init → Put local under Git management

git remote add origin ... → Link to GitHub

git branch -M main → Align local and GitHub default branch names

Cannot push without commits

This enables pushing CI/CD files like .github/workflows/main.yml

Summary

Reorganized for clarity.