【Git】「does not appear to be a git repository」エラーの原因と解決方法｜6パターン診断と完全対処ガイド

$ git push origin main
fatal: 'origin' does not appear to be a git repository
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

# 1. リモートの登録状況を確認
git remote -v
# → 何も出なければ remote未登録
# → orgin など typo がないか？
# → URLは正しいか？

# 2. Gitリポジトリ内にいるか確認
pwd
ls -la | grep "^d.*\.git$"
# → .git ディレクトリが見えるか？
# → 作業したいプロジェクトフォルダに居るか？

# 3. Gitトップディレクトリを確認（サブフォルダに居る場合）
git rev-parse --show-toplevel
# → fatal: not a git repository なら git init していない／違う場所

# HTTPS形式（トークンまたはパスワード認証）
git remote add origin https://github.com/USER/REPO.git

# SSH形式（SSH鍵認証）
git remote add origin git@github.com:USER/REPO.git

# 追加後に確認
git remote -v
# origin  https://github.com/USER/REPO.git (fetch)
# origin  https://github.com/USER/REPO.git (push)

# 初回push（upstreamを同時設定）
git push -u origin main

# 現状確認
git remote -v
# orgin  https://github.com/USER/REPO.git (fetch)  ← typo
# orgin  https://github.com/USER/REPO.git (push)

# 名前を変更
git remote rename orgin origin

# 確認
git remote -v

# push 再試行
git push -u origin main

# HTTPS に変更
git remote set-url origin https://github.com/USER/REPO.git

# SSH に変更
git remote set-url origin git@github.com:USER/REPO.git

# push 用・fetch 用で別URLを設定（稀だが可能）
git remote set-url --push origin git@github.com:USER/REPO.git
git remote set-url origin https://github.com/USER/REPO.git

# 確認
git remote -v

# .git の有無を確認
ls -la | grep "\.git$"
# 見つからないなら未初期化

# 初期化から一気にリモート設定・push まで
git init
git branch -M main
git add .
git commit -m "first commit"
git remote add origin https://github.com/USER/REPO.git
git push -u origin main

# 現在のディレクトリを確認
pwd

# Gitリポジトリのルートを表示（リポジトリ内にいる場合）
git rev-parse --show-toplevel
# → 出力が意図と違うか、fatal: not a git repository なら誤ったディレクトリ

# 正しいリポジトリに移動
cd your-project

# 念のため .git の存在を確認
ls -la | grep "\.git"

# push 再試行
git push -u origin main

# .git 内の主要ファイルを確認
ls .git/
# 正常なら config, HEAD, refs/, objects/ などが並ぶ

# fsck で整合性チェック
git fsck --full

# config だけ壊れていないか確認
cat .git/config
# [remote "origin"] セクションがあるか？

# アプローチA: リモートが生きていれば再cloneが最速
cd ..
mv your-project your-project.broken
git clone https://github.com/USER/REPO.git your-project
# 変更があれば broken 側から必要ファイルだけコピー

# アプローチB: config だけ書き直す
# .git/config を開いて [remote "origin"] セクションを追加
# もしくは
git remote add origin https://github.com/USER/REPO.git

# アプローチC: オブジェクトDBが壊れている場合
git fsck
# dangling commit などから復旧できる場合もあるが、基本は再cloneが安全

# プロジェクトフォルダに移動
cd your-project

# Gitリポジトリ初期化
git init

# デフォルトブランチをmainに
git branch -M main

# 最初のコミット
git add .
git commit -m "feat: initial commit"

# リモートを追加（HTTPS or SSH 好きな方）
git remote add origin https://github.com/USER/REPO.git

# 初回push（upstream同時設定）
git push -u origin main

# WSL内ではWSLネイティブパスで作業（速い＆安全）
mv /mnt/c/dev/your-project ~/dev/your-project
cd ~/dev/your-project
git remote -v

# どうしてもWindows側パスで使うなら safe.directory を追加
git config --global --add safe.directory /mnt/c/dev/your-project

# 改行コード設定を統一
git config --global core.autocrlf input

# submodule の初期化
git submodule update --init --recursive

# submoduleに入ってからremote確認
cd path/to/submodule
git remote -v

# 足りなければ同様に remote add
git remote add origin https://github.com/USER/SUBMODULE.git

# mirror clone（全ref含む）
git clone --mirror https://github.com/USER/REPO.git

# mirror の場合 origin は自動で「push先＝自分」になるので別名追加
cd REPO.git
git remote add upstream https://github.com/OTHER/REPO.git

# 通常のリモート設定
git remote -v

# 複数GitHubアカウントを切り替えたい場合
cat >> ~/.ssh/config << "EOF"
Host github-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_personal
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_work
EOF

# remoteでエイリアスを使う
git remote set-url origin git@github-personal:USER/REPO.git

pwd
# /Users/me/projects  ← プロジェクト外

cd your-project
git remote -v   # originが正しく表示されるはず
git push -u origin main

cd your-project
git init
git branch -M main
git add .
git commit -m "feat: initial commit"
git remote add origin git@github.com:USER/REPO.git
git push -u origin main

git remote set-url origin https://github.com/USER/NEW_NAME.git
git remote -v
git pull
git push

# origin は自分のfork、upstream は本家
git remote add upstream https://github.com/UPSTREAM_OWNER/REPO.git
git remote -v
# origin    ... (fetch/push)
# upstream  ... (fetch/push)

# 本家の最新を取り込む
git fetch upstream
git rebase upstream/main
# push は自分のforkへ
git push origin main