コミットメッセージ作成

type(scope)!: 件名 の Conventional Commits 1.0.0 形式でメッセージを組み立て、そのまま貼れる git commit -m コマンドも作ります。下の欄では書いたメッセージの形式を検査できます。

    COMMIT_EDITMSG
    50
    72

    git commit コマンド

    段落ごとに -m を分けます(git は -m の間に空行を入れてつなぎます)。bash では \ " $ ` をエスケープし、履歴展開を避けるため ! は '!' にしています。PowerShell はシングルクォートで囲み、' を '' にしています。

    メッセージを検査

    Conventional Commits 1.0.0 の仕様で意味が決まっている type は feat(SemVer の MINOR 相当)と fix(PATCH 相当)だけで、ほかの type は Angular の規約や commitlint の config-conventional で広く使われているものです。! または BREAKING CHANGE: フッターは MAJOR 相当の変更を表します。チームやリポジトリで決めたルールがあればそちらを優先してください。

    件名50桁・本文72桁は git の慣習的な目安で、仕様の必須条件ではありません。入力はこの端末のブラウザ内にだけ保存され、送信はしません。

    コミットメッセージ作成でできること

    Conventional Commits 1.0.0 の形式(type(scope)!: 件名)でコミットメッセージを組み立て、貼り付けて使える git commit コマンドまで作ります。書いたメッセージの形式や長さを検査する欄もあります。

    使い方

    1. 「type(種類)」を選び、必要なら「scope(範囲・任意)」を入れます。各 type の意味は選択肢と下の説明に出ます。
    2. 「件名」を命令形で書きます。1行目の文字数と桁数が表示され、50桁超え・末尾のピリオド・added のような過去形があると注意が出ます。
    3. 互換性を壊す変更なら「破壊的変更あり」にチェックし、「BREAKING CHANGE: の内容」を書きます。「本文」と「フッター」(Refs: #123 など)も必要に応じて入れます。
    4. 右のプレビューを確認し、「メッセージをコピー」か、シェルを選んで「コマンドをコピー」を押します。
    5. 「メッセージを検査」に既存のメッセージを貼ると、1行目の形式・2行目の空行・行の長さ・フッターの形をチェックします。

    計算の仕組みと注意点

    よくある質問

    feat と fix 以外の type は何を使えばいいですか?

    ドキュメントだけなら docs、動作を変えない整理なら refactor、テストなら test、CI 設定なら ci のように使い分けるのが一般的です。「type(種類)」の選択肢にそれぞれの日本語の説明があります。

    破壊的変更はどう書けばいいですか?

    1行目の type(scope) の後に ! を付けるか、フッターに「BREAKING CHANGE: 内容」を書きます。「破壊的変更あり」にチェックして内容を入れると、両方を付けたメッセージになります。

    コミットメッセージの1行目は何文字までが目安ですか?

    50桁以内が目安で、72桁を超えると git log や GitHub で切れて表示されやすくなります。件名の下に文字数と桁数が出るので、確かめながら書けます。

    git commit -m で ! を含むメッセージがエラーになるのはなぜですか?

    bash や zsh ではダブルクォートの中の ! が履歴展開として解釈されるためです。このツールの bash 用コマンドは ! を '!' に置き換えているので、そのまま貼り付けて実行できます。