Git コマンド早見表 — やりたいこと別

git config set --global user.name "Ana Lee"
git config set --global user.email "ana@example.com"

従来の書き方：git config --global user.name "Ana Lee"

すべてのコミットに記録されます。コミットが自分のアカウントにひも付くよう、Git ホスティングサービスに登録したメールアドレスを使ってください。

git config set --global init.defaultBranch main

従来の書き方：git config --global init.defaultBranch main

設定しないと、git init は今も最初のブランチを master と名付けます（ヒントも表示されます）。

git config set --global core.editor "code --wait"

従来の書き方：git config --global core.editor "code --wait"

ファイルを閉じるまで待機するコマンドなら何でも使えます："nano"、"vim"、"subl -n -w"。

git config set --global core.autocrlf true  # Windows
git config set --global core.autocrlf input  # macOS, Linux

従来の書き方：git config --global core.autocrlf true

コミットは LF で、Windows ではチェックアウト時に CRLF にします。チーム全体なら、個人ごとの設定より "* text=auto" を書いた .gitattributes ファイルのほうが確実です。

git --version

git switch と git restore には 2.23 以降、git config のサブコマンドには 2.46 以降が必要です。

git init
git init -b main  # name the first branch

.git ディレクトリを作成します。ビルド成果物や機密情報が入らないよう、最初のコミットの前に .gitignore を追加しましょう。

git clone https://github.com/owner/repo.git
git clone git@github.com:owner/repo.git my-folder

全履歴をダウンロードし、リモート "origin" を設定します。2 つ目の形式は SSH を使い、フォルダー名を指定します。

git clone --depth 1 https://github.com/owner/repo.git

履歴を省略します。CI や大きなリポジトリ向けです。残りは後から git fetch --unshallow で取得できます。

git remote add origin git@github.com:owner/repo.git
git push -u origin main

先にホスティングサービス側で空のリポジトリを作成してください（または下の gh repo create を使用）。-u で origin/main を上流ブランチとして記憶します。

git status
git status -s  # short form

ステージ済み、未ステージ、未追跡のファイルを一覧表示し、次に実行するコマンドを提案します。

git add file.txt
git add .  # everything in this folder and below

git add -A はリポジトリ全体の削除もステージします。

git add -p file.txt

変更（「hunk」）を 1 つずつ確認します。y でステージ、n でスキップ、s で分割、e で編集。

git commit -m "Add login form"
git commit -am "Fix typo"  # stage tracked files and commit

-a は変更・削除された追跡済みファイルを含めますが、新しいファイルは含めません。

git mv old.txt new.txt
git rm file.txt

どちらも変更を自動でステージします。Git は内容から名前変更を検出するので、普通の mv と git add でも大丈夫です。

git rm --cached .env
echo ".env" >> .gitignore

次のコミット以降、リポジトリから削除されます。以前のコミットには残るため、機密情報が含まれていた場合はその情報を無効化して再発行してください。

git branch
git branch -a  # include remote branches
git branch -vv  # show upstream and ahead/behind

現在のブランチには * が付きます。

git switch -c feature/login

従来の書き方：git checkout -b feature/login

現在のコミットから始まります。別の場所から分岐するには起点を指定します：git switch -c hotfix origin/main。

git switch main
git switch -  # back to the previous branch

従来の書き方：git checkout main

origin/feature しかない場合、git switch feature でローカルの追跡ブランチが自動的に作成されます。

git branch -m new-name  # current branch
git branch -m old-name new-name

ローカルだけの変更です。リモートでも変更するには次の項目を参照してください。

git branch -m old-name new-name
git push -u origin new-name
git push origin --delete old-name

リモートで直接名前を変える操作はないため、新しい名前を push して古い名前を削除します。古い名前に対して開いているプルリクエストは閉じられることがあります。GitHub の Web 画面の名前変更ボタンなら、プルリクエストの対象も付け替えられます。

git branch -u origin/main
git push -u origin HEAD  # push current branch and track it

従来の書き方：git branch --set-upstream-to=origin/main

上流ブランチは、引数なしの git pull と git push が使うブランチです。

git switch --detach a1b2c3d
git switch -c rescue  # keep work made there

従来の書き方：git checkout a1b2c3d

detached の状態で作ったコミットはどのブランチにも属しません。他へ切り替える前にブランチを作らないと、reflog からしかたどれなくなります。

git switch main
git merge feature/login
git merge --no-ff feature/login  # always create a merge commit

可能ならファストフォワードします。--no-ff を付けると履歴にブランチが残ります。

git merge --squash feature/login
git commit -m "Add login"

まとめた変更をステージしますが、マージとしては記録しません。そのためブランチはマージ済みとして扱われません。

git status  # list conflicted files
# edit the files, remove <<<<<<< ======= >>>>>>> markers
git add file.txt
git commit  # or: git rebase --continue

片方を丸ごと採用するには git restore --ours file.txt または --theirs を使います。リベース中は「ours」がリベース先のブランチを指し、マージとは逆になります。

git pull --rebase
git config set --global pull.rebase true  # make it the default

取得した内容の上にローカルのコミットをリベースします。

git cherry-pick a1b2c3d
git cherry-pick -x a1b2c3d  # note the source in the message

同じ変更を持つ新しいコミットを作ります。範囲指定：git cherry-pick A..B（A は含まない）。

git remote -v
git remote set-url origin git@github.com:owner/repo.git

set-url でクローンの接続先を HTTPS から SSH に（または名前が変わったリポジトリに）切り替えます。

git fetch
git fetch --prune  # also drop deleted remote branches

origin/* だけを更新し、自分のブランチには触れません。

git pull

git fetch とマージ（pull.rebase を設定していればリベース）。

git push
git push -u origin HEAD  # first push of a new branch
git config set --global push.autoSetupRemote true

push.autoSetupRemote（Git 2.37 以降）を設定すると、新しいブランチで引数なしの git push を実行するだけで上流ブランチが設定されます。

git remote add upstream https://github.com/original/repo.git
git fetch upstream
git switch main
git merge upstream/main

GitHub CLI なら gh repo sync でも可能です。

git revert a1b2c3d
git revert HEAD  # the latest commit

元のコミットを打ち消す新しいコミットを追加するので、他の人の履歴は変わりません。共有ブランチで安全に取り消す方法です。

git revert -m 1 <merge-sha>

-m 1 で 1 番目の親（通常は main）を残します。後でそのブランチを再マージするには、先にこの revert を revert する必要があります。

git restore --staged file.txt
git restore --staged .  # everything

従来の書き方：git reset HEAD file.txt

変更は作業ツリーに残り、ステージだけが取り消されます。

git restore file.txt  # deletion not committed
git restore --source=a1b2c3d~1 file.txt  # deleted in commit a1b2c3d

従来の書き方：git checkout a1b2c3d~1 -- file.txt

削除したコミットは git log --diff-filter=D -- file.txt で探せます。

git reflog
git branch rescued a1b2c3d

reflog には HEAD がたどったすべての位置が記録されています。ミスの前の SHA を探して、そこにブランチを作ります。

git stash
git stash push -m "half-done login"
git stash -u  # include untracked files

追跡中のファイルの変更を保存して作業ツリーをきれいにするので、ブランチを切り替えられます。

git stash pop  # apply and drop
git stash apply stash@{1}  # apply, keep the stash

コンフリクトが起こることがあります。pop では、適用に失敗した場合 stash は残ります。

git stash list
git stash show -p stash@{0}

新しい順に並び、stash@{0} が最新です。

git stash push -- src/login.ts
git stash push --staged  # only what is staged (2.35+)

パスを指定した stash では、それ以外はそのまま残ります。

git stash branch feature/login stash@{0}

stash したコミットにブランチを作り、stash を適用して削除します。コンフリクトを避けられます。

git log --oneline --graph --all

1 コミット 1 行でブランチ構造を表示します。かなり古い Git ではブランチ名を表示するのに --decorate を追加します。

git log --follow -p -- path/file.txt

--follow で名前変更をまたいで追跡し、-p で各変更を表示します。

git log -S "functionName" --oneline
git log -G "regex" --oneline

-S は出現回数が変わったものを、-G は変更された行を正規表現で照合します。

git log --author="Ana" --since="2 weeks ago" --oneline

ほかに --until、メッセージ検索の --grep="fix"、main にはなく feature にあるコミットを示す main..feature も使えます。

git show a1b2c3d
git show a1b2c3d:path/file.txt

2 つ目の形式は、作業コピーに触れずに、そのコミット時点のファイルを表示します。

git diff  # unstaged
git diff --staged  # staged, i.e. what will be committed

--stat はファイルごとに要約し、--word-diff は文章の比較に向いています。

git diff main...feature  # changes on feature since it branched
git diff main feature  # the two tips directly

ドット 3 つはマージベースと比較します。プルリクエストで表示されるのはこれです。

git blame -L 10,20 path/file.txt

-w で空白を無視し、-C で他のファイルから移動した行を追跡します。

git bisect start
git bisect bad  # current commit is broken
git bisect good v1.4.0  # this one worked
# test, then mark each step good or bad
git bisect reset

二分探索で、約 log2(n) ステップです。git bisect run ./test.sh で自動化できます。

git grep -n "TODO"

大きなリポジトリでは grep より速く、無視されたファイルはスキップします。コミットを指定すると古いバージョンを検索できます。

git tag -a v1.2.0 -m "Release 1.2.0"
git tag -a v1.1.1 a1b2c3d -m "Hotfix"  # tag an older commit

注釈付きタグ（-a）は作成者、日付、メッセージを保存するので、リリースにはこちらがおすすめです。git tag v1.2.0 だけだと軽量タグになります。

git push origin v1.2.0
git push --follow-tags  # annotated tags reachable from pushed commits

git push は既定ではタグを送りません。git push --tags は不要なローカルタグも含めすべてのタグを送ります。

git tag -l "v1.*"
git describe --tags

describe は最も近いタグとそれ以降のコミット数を表示します（例：v1.2.0-3-ga1b2c3d）。

git submodule add https://github.com/owner/lib.git vendor/lib
git commit -m "Add lib submodule"

.gitmodules に URL を記録し、もう一方のリポジトリの特定のコミットに固定します。

git clone --recurse-submodules <url>
git submodule update --init --recursive  # already cloned

これを実行しないと、サブモジュールのフォルダーは空のままです。

git submodule update --remote
git commit -am "Bump submodules"

各サブモジュールの追跡ブランチを取得します。新しい固定先は親リポジトリでコミットしてください。

git worktree add ../repo-hotfix hotfix
git worktree add -b review ../repo-review origin/main

同じリポジトリを共有する 2 つ目の作業フォルダーです。stash や 2 つ目のクローンは不要です。

git worktree list
git worktree remove ../repo-hotfix
git worktree prune  # forget folders deleted by hand

未コミットの変更があると remove は拒否します（強制するには --force）。

git clean -n -d

git clean -f の前には必ず実行してください。

git branch --merged main
git branch -d branch-a branch-b

先に一覧を確認してください。-d は未マージのブランチを拒否するので、試しても安全です。

git fetch --prune
git config set --global fetch.prune true

サーバー上で削除されたブランチの origin/* 参照を削除します。

git maintenance start
git gc

maintenance start はバックグラウンドの prefetch、commit-graph、repack のジョブをスケジュールします。gc はその場でオブジェクトをパックし、到達不能なものを削除します。

git config list --show-origin

従来の書き方：git config --list --show-origin

システム、グローバル、リポジトリの値を、それぞれが書かれたファイルと一緒に表示します。

git config set --global alias.st "status -s"
git config set --global alias.lg "log --oneline --graph --all"

従来の書き方：git config --global alias.st "status -s"

その後は git st や git lg が使えます。! を先頭に付けるとシェルコマンドを実行します：alias.root "!pwd"。

git config set --global pull.rebase true
git config set --global push.autoSetupRemote true
git config set --global rerere.enabled true
git config set --global merge.conflictStyle zdiff3
git config set --global diff.algorithm histogram

従来の書き方：git config --global pull.rebase true

pull 時にリベース、初回 push で上流を自動設定（2.37 以降）、コンフリクトの解決を記憶、コンフリクトに共通の祖先を表示（2.35 以降）、より見やすい差分。

git config set --global core.excludesFile ~/.gitignore_global

従来の書き方：git config --global core.excludesFile ~/.gitignore_global

OS やエディターが作る不要ファイル（.DS_Store、.idea/）向けです。プロジェクト固有のルールはリポジトリの .gitignore に書きます。

gh auth login
gh auth setup-git  # let git use gh for HTTPS credentials

ブラウザを開くか、トークンを受け付けます。github.com と GitHub Enterprise の両方で使えます。

gh repo create my-app --private --source=. --push

リポジトリを作成して origin として追加し、現在のブランチを push します。

gh repo clone owner/repo

フォークの場合は、親リポジトリも upstream リモートとして追加します。

gh pr create --fill
gh pr create --draft --title "WIP: login" --body "…"

--fill でコミットメッセージをタイトルと本文に使います。

gh pr checkout 123

PR のブランチ（フォークを含む）を取得して切り替えます。

gh pr list
gh pr view 123 --web
gh pr merge 123 --squash --delete-branch

gh pr status で自分に関係する PR を表示します。

gh issue create --title "Bug: …" --body "…"
gh issue list --assignee @me

gh issue view 42 --comments でスレッドをターミナルで読めます。

gh run list
gh run watch

gh run view --log-failed で失敗したステップだけを表示します。