良い commit メッセージを書く
未来のあなたが感謝するメッセージ
⏱ 想定 ~8 分
01 · 読む
良い commit メッセージは、未来のあなた(とチームメイト)へのプレゼントです。なぜ 変更したかを説明するべきです、何を変更したかだけではなく。明確なメッセージが git の履歴を本当に役立つものにします。
💡 想像してみてください良い commit メッセージを書くのは、写真の裏にラベルを貼るようなものです。「3 歳の誕生日パーティー、おばあちゃんの家で」はとても役に立ちます。「写真」は役に立ちません。数か月後、これらのラベルだけが、各スナップショットが何を写しているか思い出させてくれます。
ポイントまとめ
- 良いメッセージは なぜ を説明する: 'Fix login timeout for slow connections'
- 悪いメッセージは曖昧: 'fixed stuff'、'update'、'asdf'
- 1 行目は短く(50 文字以内)、命令形で: 'Add'、'Fix'、'Update'
02 · ターミナル演習
HTML と CSS を含むブログプロジェクトがあります。完全なフローで良い commit メッセージを書く練習をしましょう。
（このセクションはインタラクティブです — JavaScript を有効にしてください。）
03 · ターミナル演習
すべてのファイルを stage して、最初の commit をしましょう。
（このセクションはインタラクティブです — JavaScript を有効にしてください。）
04 · ターミナル演習
最初の commit は、このプロジェクトに何が入っているかを説明するべきです。'first commit' とだけ書かない —— 出発点が何かを具体的に書きましょう。
（このセクションはインタラクティブです — JavaScript を有効にしてください。）
05 · クイズ
次のどの commit メッセージがベストプラクティスに沿っていますか?
- "fixed stuff"
- "Add user login validation for email format"
- "update"
- "changes"
06 · ターミナル演習
ブログに新機能を追加しましょう —— ナビゲーションバーです。
（このセクションはインタラクティブです — JavaScript を有効にしてください。）
07 · ターミナル演習
編集したファイルを Stage しましょう。
（このセクションはインタラクティブです — JavaScript を有効にしてください。）
08 · ターミナル演習
この変更の commit メッセージを書きましょう。何を追加したかを説明する —— 'update' とは書かない。良い例: 'Add navigation bar to blog'、'Add nav links for Home, About, Contact'。
（このセクションはインタラクティブです — JavaScript を有効にしてください。）
09 · クイズ
次のどの commit メッセージが、最もプロの慣習に合っていますか?
- "updated stuff"
- "asdfjkl"
- "Fix password reset for expired tokens"
- "I changed the login page to fix a bug where users couldn't log in when their session expired after 24 hours"
⚠ 全機能のインタラクティブ体験には JavaScript が必要です。JavaScript を有効にして再読み込みしてください。
※ このサイトは独立した教育プロジェクトで、Anthropic の公式製品ではありません。Claude™ は Anthropic, PBC の商標です。