GitHub・プルリク・Update branch・2026年10月27日に確認

GitHub：プルリクに Update branch のボタンが出ない

リポジトリでプルリクのブランチの更新をいつも勧める設定がオンなら、書き込みの権限がある人は、プルリクの head のブランチがマージ先に追いついていないとき、いつでもプルリクのページから更新できます。オフなら、更新できるのは、マージ先のブランチがマージの前に最新であることを求めていて、ブランチが最新でないときだけです（GitHub の説明「プルリクのブランチの更新の勧めを管理する」・2026年10月27日に確認）。

Always suggest updating pull request branches   on: shown whenever behind
setting off                                     shown only when the rules require up to date
merge conflicts                                 resolve them first
protected head branch                           the button may not work
PUT /repos/{owner}/{repo}/pulls/{pull_number}/update-branch   merge
updatePullRequestBranch(updateMethod: REBASE)                 rebase

出ない理由

設定がオフ：Always suggest updating pull request branches が無ければ、ボタンはマージ先が最新のブランチを求めるときだけ出ます。Strict（Require branches to be up to date before merging にチェック）ならマージの前にブランチが最新である必要があり、Loose なら要りません（GitHub の説明「保護されたブランチについて」）。
競合がある：プルリクのページから更新できるのは、マージの競合が無く、ブランチがマージ先より遅れているときです。先に競合を解きます（GitHub の説明「プルリクをマージ先に合わせておく」）。
head のブランチが保護されている：プルリクの head のブランチが保護されたブランチだと、Update branch を使えないことがあります。
取り込む物が無い：ブランチがマージ先より遅れていません。

直す所

勧めをオンにする：リポジトリの設定の Pull Requests で、Always suggest updating pull request branches を選びます。
マージかリベースを選ぶ：マージの欄の Update branch は、マージ先を head のブランチにマージします。その横のメニューの Update with rebase から Rebase branch を選ぶと、自分の変更を最新のマージ先の上にリベースし、マージのコミットは作りません。
REST API で：PUT /repos/{owner}/{repo}/pulls/{pull_number}/update-branch は、マージ先の HEAD をプルリクのブランチにマージします。expected_head_sha が head と合わないと 422 です（GitHub の説明「Update a pull request branch」・ブランチの更新を断られた理由）。
GraphQL で：updatePullRequestBranch はマージかリベースで更新し、updateMethod は MERGE か REBASE、省くと MERGE です（GitHub の説明「updatePullRequestBranch」と「PullRequestBranchUpdateMethod」）。
マージキューに任せる：マージキューは、ブランチの最新を求めるのと同じ利点があり、プルリクの作者にブランチの更新とステータスチェックの完了待ちを求めません（GitHub の説明「保護されたブランチについて」・マージキュー）。

IntelliJ IDEA に Update branch は無く、ブランチが遅れていることを示す行も無い

IntelliJ IDEA に入っている GitHub の機能が、ブランチがマージ先より遅れているプルリクをどう扱うか。ソース（2026年10月31日に確認・IntelliJ IDEA：GraphQL のファイル・GithubApiRequests.kt・GHPullRequestMergeStateStatus.kt・GHPRMergeabilityStateBuilder.kt・GHPRMergeabilityState.kt・CodeReviewDetailsStatusComponentFactory.kt）では：

Update branch は無い：GraphQL のファイルに updatePullRequestBranch は無く、REST の問い合わせも update-branch を呼びません。そのため IDE から GitHub 上のプルリクのブランチを更新することはできません。
遅れは出ない：GitHub の mergeStateStatus が BEHIND だと、Merge… と Squash and Merge… は Admin 以外は押せなくなります（自動マージが断られた理由）。ただし IDE が状態の欄に渡す物にはそれを表す所が無いので、ブランチが古いと出る行はありません。
Resolve（IDE で行うマージ先のマージか rebase・プルリクがマージ先と衝突している）は、GitHub が衝突を返したときだけ出ます。遅れているだけのブランチは、git で更新して push するか、GitHub の Update branch を使います。

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

Lesstep の Pull Request Inbox for GitHub は、JetBrains IDE（2024.1 以降）のプラグインです。プルリクのレビュー・チェック・会話を差分の隣に出し、対象のブランチが許す方法でマージします。プルリクとマージ先を自分で比べるので、マージ先にプルリクがまだ持っていないコミットがあり、両者が衝突していなければ、リポジトリが勧める設定かどうかにかかわらず「ブランチを更新」を出します。ルールが最新のブランチを求めているときは、マージのチェックに「ルールでその取り込みが必要です」と出ます。更新は REST API でのマージで、リベースはしません。Dependabot が開いたプルリクでは、代わりに @dependabot rebase とコメントするよう出します。受信箱・差分・会話は無料、承認・コメント・解決・マージ・ブランチの更新は Pro（月 US$1.50・30日間の無料試用つき）です。画面は日本語です。

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