GitHub・プルリク・マージ・2026年10月28日に確認

GitHub：マージのコミットメッセージが思った形にならない

スカッシュしてマージすると、GitHub は編集できる既定のコミットメッセージを作ります。中身はリポジトリの設定とプルリクのコミットの数によって、プルリクのタイトル、プルリクの説明、コミットの情報のどれかを含みます（GitHub のスカッシュでのマージのメッセージ・2026年10月28日に確認）。マージコミットにも同じように設定する既定のメッセージがあります。

既定のメッセージはどこで決まるか

スカッシュしてマージ：リポジトリの Settings の Pull Requests の欄、Allow squash merging の下のメニューで、既定のスカッシュのコミットメッセージの形を選びます。既定の形は、プルリクのコミットが1つならそのコミットのタイトルとメッセージ、2つ以上ならプルリクのタイトルとコミットの一覧です。ほかに、プルリクのタイトルだけ、プルリクのタイトルとコミットの詳細、プルリクのタイトルと説明を選べます（GitHub のプルリクのコミットのスカッシュの設定）。
マージコミット：Allow merge commits の下では、既定のメッセージはプルリクの番号とタイトルを含みます（例：Merge pull request #123 from patch-1）。ほかに、プルリクのタイトルだけ、プルリクのタイトルと説明を選べます（GitHub のプルリクのコミットのマージの設定）。
リベースしてマージ：head のブランチのコミットを1つずつ、マージコミットを作らずにマージ先へ足します（Rebase and merge が使えないを参照）。
API では：リポジトリの更新で、squash_merge_commit_title（PR_TITLE、または COMMIT_OR_PR_TITLE＝コミットが1つならそのコミットのタイトル、2つ以上ならプルリクのタイトル）、squash_merge_commit_message（PR_BODY・COMMIT_MESSAGES・BLANK）、merge_commit_title（PR_TITLE、または MERGE_MESSAGE＝Merge pull request #123 from branch-name のような昔ながらのタイトル）、merge_commit_message（PR_BODY・PR_TITLE・BLANK）で既定を決めます（GitHub のリポジトリの更新）。

思った形にならない理由

コミットが1つか複数か：既定の形では、コミットが1つのプルリクのスカッシュはそのコミットのタイトルとメッセージを、2つ以上のプルリクのスカッシュはプルリクのタイトルとコミットの一覧を使います。2つ目のコミットが入ったプルリクは、既定も変わります。
このリポジトリは別の形：Allow squash merging と Allow merge commits の下のメニューが、マージする人に出す既定のメッセージの形を決めます。
マージのときに書き換えた：GitHub の画面では、求められたらコミットメッセージを書くか、既定のメッセージをそのまま使います（GitHub のプルリクのマージ）。
API でマージした：REST のマージは、自動のコミットメッセージのタイトルになる commit_title と、自動のコミットメッセージに足す詳細の commit_message を受け取ります（GitHub のプルリクのマージ）。非同期のマージでは、どちらも直接のマージでだけ使えます。GraphQL の mergePullRequest は commitHeadline と commitBody を受け取り、省くと既定のメッセージを使います（GitHub の mergePullRequest）。
自動マージとマージキュー：自動マージは、オンにしたときに渡したコミットのタイトルと本文を使い、省いたときは既定のメッセージを使います。マージキューでマージするときは、渡したコミットのタイトルやメッセージは無視され、マージキューが決めます（GitHub の enablePullRequestAutoMerge と AutoMergeRequest・マージキューでのマージも参照）。

どうするか

設定を見る：リポジトリの Settings の General の Pull Requests、Allow squash merging と Allow merge commits の下のメニューです。設定を変えられる人が、別の形を選べます。
マージのときに書く：マージの欄でタイトルとメッセージを書き換えるか、REST のマージに commit_title と commit_message、GraphQL のマージに commitHeadline と commitBody を渡します。
共同作者：Co-authored-by の行はコミットメッセージの一部です。スカッシュでマージする前に、できるコミットのメッセージにその行があるかを見ます（共同作者が数えられないを参照）。
コミットメッセージの規則：スカッシュでのマージでは、コミットメッセージのブランチの規則は、できたコミットを調べます（コミットのメタデータの規則を参照）。

IntelliJ IDEA で GitHub のプルリクを見るなら

Lesstep の Pull Request Inbox for GitHub は、JetBrains IDE（2024.1 以降）のプラグインです。プルリクのレビュー・チェック・会話を差分の隣に並べ、対象のブランチが許す方法でマージします。マージの画面には、マージコミットとスカッシュのためのコミットのタイトルの欄があり、書いた物をコミットのタイトルとして送ります。空なら GitHub の既定のタイトルになります。コミットメッセージは送らないので、残りは GitHub の自動のメッセージです。リベースしてマージとマージキューでは、この欄はオフです。受信箱・差分・会話は無料、承認・コメント・解決・マージは Pro（月 US$1.50・30日間の無料試用つき）です。画面は日本語です。

GitHub は GitHub, Inc. の商標、IntelliJ IDEA は JetBrains s.r.o. の商標です。このページは GitHub, Inc.・JetBrains のいずれとも提携しておらず、承認も受けていません。