「git pullできません」の謎を解明！push.autoSetupRemote で新ブランチのUpstream設定を自動化する神ハック

手元のメモを見返していたら、ふと思い出した過去の「地味なイライラ」がありました。

ローカルで新しくブランチ（feature/... など）を切って作業し、いざ git pull をしようとすると、

「Upstream（追跡関係）が設定されていません！」

ってターミナルに怒られて弾かれる現象です（#^ω^）

「えっ、いつも通り git pull したいだけなのに！？いちいち git pull origin feature/xxx とか長々とブランチ名を書きたくないんだけど！！^^;」

当時はAI（Gemini）に言われるがまま git push -u origin HEAD と叩いて乗り切っていたのですが、なぜ急にこれを言われるようになったのか、仕組みをちゃんと理解していませんでした。

今回は、この現象の真原因（Gitの歴史）をデバッグし、新しいMacにするたびに1回叩くだけで二度と怒られなくなる神設定 にたどり着いた記録を残しておきます(^^)

原因解明：「手元」と「リモート」のペアリングが切れていた

そもそも git pull や git push を単体で叩いたとき、Gitは心の中でこう困惑していたわけです。

Git：「手元のこのブランチ、リモート（GitHub）のどのブランチとペアリングすればいいのか分からん……指示を出してくれ！（#^ω^）」

つまり、ローカルブランチとリモートブランチの 「追跡関係（Upstream）」 が未設定だったのが原因でした。

なぜ「最近になって急に言われるようになった」気がしたのか？

「昔は意識しなくても普通に git pull できていたのに、なんで最近急に厳しくなったの？」

気になって調べてみたら、自分の操作の変化というより Git自体の安全装置（仕様の引き締め） が理由でした！

昔のGit：仕様が少し緩く、曖昧な操作でも雰囲気でpush/pullを通してくれていた（ただし、間違えて別ブランチを上書きする事故が世界中で多発！^^;）
現代のGit：事故防止のため、「ペアリング（Upstream）が明記されていない操作は危険だから拒否する」というお堅く真面目な仕様に進化！

昔からずっとターミナル派でブランチもガシガシ切っていた私ですが、Git側が真面目に進化したからこそ、急に警告されるようになった というのが真実だったのです。完全にGit側の仕様変更がビンゴでした(^^)

当時叩いていた `git push -u origin HEAD` の正体

当時、Geminiに言われるがまま打っていた呪文を解剖してみると、実はすごくスマートな処理をしてくれていました。

git push -u origin HEAD

HEAD ➔ 今開いている自分のブランチ（ブランチ名の手入力を省略！）
-u（--set-upstream） ➔ 「今回pushするだけじゃなく、今後はこのリモートブランチとペアリング（追跡）関係にして記憶しておいて！」という設定フラグ

これを1回叩けばペアリングが記憶されるので、次回からはシンプルに git pull や git push だけでも自動で判断してくれる、という仕組みだったのです。

【本題】`-u` すら叩きたくない！1行で永久全自動化する神コマンド

「仕組みは分かったけれど、新ブランチを作るたびに -u origin HEAD とか長々と打つのすら面倒くさいわ！（#^ω^）」

そう思った私に朗報でした。ターミナルで以下のコマンドを 1回叩くだけで、新ブランチのペアリングが永久に全自動化されます！

git config --global --add --bool push.autoSetupRemote true

コマンドの解剖

git config --global ➔ このMac全体（全プロジェクト共通）の設定に保存！
push.autoSetupRemote ➔ 「push時にリモートブランチを自動でセットアップ（ペアリング）する」機能
true ➔ 機能をON！

これをONにしておくと、新ブランチで初めて git push を叩いた瞬間、Gitが裏で勝手に同名のリモートブランチを作って ペアリング（-u 相当の処理）まで全自動で完了 させてくれます！

次回からは新ブランチであっても、最初から単なる git push や git pull 一発で済むようになります。神すぎる……！(^^)

自分のMacに設定が入っているか確認・設定してみた

さっそく自分のターミナルで確認と設定を行いました！

1. 現在の設定を確認（未設定だと何も返ってこない）

git config --global push.autoSetupRemote

2. 神コマンドを実行してONにする！

git config --global --add --bool push.autoSetupRemote true

3. 再び確認して「true」が返ってくれば完了！

git config --global push.autoSetupRemote
# true

見事に true が返ってきて、設定完了！(^^)

この設定は Mac の ~/.gitconfig に保存されるため、PCを再起動しようが別プロジェクトを開こうが永久に効き続けます。次に触るのは新しいMacへ買い替えた時だけ です！

まとめ：地味なストレスは環境設定（Ops）で握りつぶす

git pull が弾かれるのは、手元とリモートの Upstream（ペアリング）が未設定 だから
事故を防ぐために Gitの仕様がお堅く進化 したのが原因
push.autoSetupRemote true を1回設定すれば、新ブランチでも全自動でペアリングが完了 する！

長年の「なんで急に言われ始めたの？」というモヤモヤが解明してスッキリした上に、日々のターミナル操作のストレスまで1行で消滅しました（#^ω^）

新しいMacを買ったときの環境構築メモにも、忘れずにこの1行を追加しておこうと思います！

→ Mac設定メモ｜次に買い替えたとき用のお気に入り設定まとめ