【Git】コミットメッセージの変更方法｜amend・rebase -i reword・filter-repoの使い分け完全ガイド

# エディタで編集（Git設定のeditor が開く）
git commit --amend

# メッセージを直接指定
git commit --amend -m "fix: トークン有効期限のバグを修正"

# エディタは開かず、メッセージは変えずにファイル追加だけしたい
git add forgotten_file.py
git commit --amend --no-edit

# 作者（Author）も一緒に直したい
git commit --amend --author="New Name <new@example.com>"

# コミット日時も現時点に更新
git commit --amend --no-edit --date=now

# VS Code（--wait でGitが待機）
git config --global core.editor "code --wait"

# Cursor
git config --global core.editor "cursor --wait"

# Vim（デフォルト環境が多い）
git config --global core.editor vim

# nano（初心者向け）
git config --global core.editor nano

# JetBrains系（IntelliJ IDEA）
git config --global core.editor "idea --wait"

# 直近5コミットを対象にインタラクティブrebaseを起動
git rebase -i HEAD~5

# 特定のコミットの親から
git rebase -i a1b2c3d^

# mainから分岐後すべてを対象に
git rebase -i main

# エディタに以下のようなリストが表示される
pick a1b2c3d feat: ユーザー登録を追加
pick e4f5g6a fix: emailバリデーションを修正    # ← メッセージを直したい
pick i7j8k9l docs: README更新

# Commands:
# p, pick = コミットを使用
# r, reword = コミットを使用し、メッセージだけ編集
# e, edit = コミットを使用し、修正のために停止
# s, squash = 前のコミットに統合（メッセージ合体）
# f, fixup = 前のコミットに統合（メッセージ破棄）
# d, drop = コミットを削除

# 変更したいコミットの pick を reword に書き換える
pick a1b2c3d feat: ユーザー登録を追加
reword e4f5g6a fix: emailバリデーションを修正
pick i7j8k9l docs: README更新

# 対象コミット全部 pick を reword に書き換える
reword a1b2c3d feat: ユーザー登録を追加
reword e4f5g6a fix: emailバリデーションを修正
reword i7j8k9l docs: README更新

# 保存→閉じる → エディタが順番に開くので順次編集

# メッセージ修正
git commit --amend -m "新しいメッセージ"
# または rebase -i で reword
git rebase -i HEAD~3

# 最新リモート情報を取得してから
git fetch origin

# 安全な強制push
git push --force-with-lease origin feature/my-branch

# 1. 管理者権限でブランチ保護を一時解除（GitHub設定）
# 2. 全メンバーに周知：作業を退避してもらう
# 3. amend または rebase -i で修正
git commit --amend -m "修正メッセージ"

# 4. --force-with-lease で反映
git fetch origin main
git push --force-with-lease origin main

# 5. 全メンバーに周知：
# 各自：git fetch origin && git reset --hard origin/main

# インストール（まだなら）
pip install git-filter-repo

# ミラーcloneを推奨（安全のため）
git clone --mirror https://github.com/user/repo.git repo-mirror
cd repo-mirror

# コールバックでメッセージ置換
git filter-repo --message-callback '
import re
return re.sub(rb"^fix ", b"fix: ", message, flags=re.MULTILINE)
'

# 同じプロジェクトの別ディレクトリで作業するなら --force を付ける
git filter-repo --force --replace-message ../replacements.txt

# 旧 filter-branch の例（使わないでください）
# git filter-branch --msg-filter 'sed "s/old/new/g"' HEAD

# 新 filter-repo での同等処理
git filter-repo --replace-message expressions.txt
# expressions.txt の中身例:
# old==>new

# リポジトリ／全体のテンプレート作成
cat > ~/.gitmessage.txt << "EOF"
# <type>(<scope>): <subject>
# 
# type: feat / fix / docs / style / refactor / test / chore
# scope: auth / api / ui など（省略可）
# 
# <body: なぜ変更したかの説明>
# 
# <footer: BREAKING CHANGE / refs #issue など>
EOF

# グローバル設定
git config --global commit.template ~/.gitmessage.txt

# リポジトリ個別
git config commit.template .gitmessage.txt

# .git/hooks/commit-msg
#!/bin/sh
pattern="^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: .+"
msg=$(head -1 "$1")
if ! echo "$msg" | grep -qE "$pattern"; then
  echo "エラー: Conventional Commits形式で書いてください" >&2
  echo "例: feat(auth): Add OAuth support" >&2
  exit 1
fi

# push前の典型パターン
git commit --amend -m "fix: ログイン失敗時のエラーメッセージを修正"

# push済みの個人ブランチなら
git commit --amend -m "..."
git push --force-with-lease origin feature/xxx

git rebase -i HEAD~5
# エディタで該当コミットを pick → reword に変更
# 保存して閉じる → メッセージ編集用エディタが開くので書き換えて保存

# 個人ブランチなら強制push
git push --force-with-lease origin feature/xxx

# 単一コミットのDCO署名を追加
git commit --amend --no-edit --signoff

# 過去N件に一括追加
git rebase --exec 'git commit --amend --no-edit --signoff' -i HEAD~5
# rebase -i で全コミットを pick のままにして実行

# 直前のコミットの作者
git commit --amend --author="Name <email@example.com>" --no-edit

# 過去コミットの作者を一括変更（filter-repo）
git filter-repo --email-callback '
return email.replace(b"old@example.com", b"new@example.com")
'