Bitbucket のコードの提案:取り込み方と、うまくいかないとき
プルリクエストの行へのコメントで、レビュアーはその行がどうなるべきかをコードで書けます。作成者はボタンでそれを取り込み、ソース ブランチの新しいコミットになります。Bitbucket Cloud には2025年7月21日からあります(BCLOUD-17360・313票)。Bitbucket Data Center には Bitbucket Server 6.6 からあり、9.3.0 で複数行の提案ができるようになるまでは1行ずつでした(BSERV-12219・461票)。
提案と取り込み
- Bitbucket Cloud(Atlassian の説明):差分の行の横の + を選びます。複数行なら、そこから最後の行までドラッグします。エディターのツールバーの「Suggest code」か、
/suggestcodeと入力して、新しいコードを書きます。プルリクエストの作成者か、リポジトリに書き込み権限のあるメンバーが「Apply suggestion」、続けて「Commit changes」を選ぶと、プルリクエストが読み直され、差分に変更が入ります。 - Bitbucket Data Center(Atlassian の説明):コメント欄の提案のボタンで、新しいコードを書くコード ブロックがコメントに入ります。ソース リポジトリに書き込み権限のある人が「Apply suggestion」を選び、必要ならコミット メッセージを直して「Commit changes」を選ぶと、プルリクエストに新しいコミットが加わります。
- 提案は1つずつ、それぞれのコミットとして取り込まれます。いくつかを1つのコミットにまとめたいという要望は未対応です(BSERV-12163・14票)。
- コメントの本文では、提案は
```suggestionで始まるコード ブロックです。Cloud の REST API では、content.rawにそのブロックを持ち、inlineのstart_toとtoで行を示すコメントになります(下の BCLOUD-24074 のとおり)。
知られている問題
Atlassian の公開の課題管理から(2026年10月26日時点):
- タブが空白になる(Cloud)。提案したコードがタブで字下げされていると、取り込むと空白4つで書かれ、誰も提案していない空白の変更になります(BCLOUD-24074・2026年4月の報告・10票・未解決)。マージの前にコミットの空白を見てください。
- ファイルのほかの文字が変わる(Cloud)。ファイルの別の場所に Unicode の文字があると、提案を取り込んだときにそれも変わることがあります。回避策はその文字を戻すことです(BCLOUD-23990・2026年1月・未解決)。
- 提案の中のバッククォート(Cloud)。提案する文にコード ブロック(バッククォート3つ)が入っていると、そこで提案が早く閉じ、残りはふつうのコメントの文として出ます(BCLOUD-24193・2026年7月・未解決)。
- CRLF が LF になる(Data Center)。Windows の改行のファイルで提案を取り込むと、CR が消えます(BSERV-13105・6.7.0 と 7.19.2 で確認・長期の積み残し)。
- フックがコミットを断る(Data Center)。pre-receive フックや Yet Another Commit Checker などのアプリが、取り込みで作るコミットを断ることがあります。7.14.0 より前は、そのとき出るのは中身の無いエラーで、ボタンをもう一度使えませんでした(BSERV-12528・7.14.0 で修正)。
- 提案が違う行に付く(Data Center)。上に行を足すプッシュの後に読み直していないページで書いた提案は、ページを読み直すと違う行を指します(BSERV-19539・長期の積み残し)。提案の前にプルリクエストを読み直してください。
- 空の行(Data Center 9.3.0)。空の行への提案が、提案ではなくふつうのコード ブロックとして出ていました。9.3.1 と 9.4.0 で修正(BSERV-19714)。
IntelliJ IDEA で提案を読む
Pull Request Inbox for Bitbucket は、Lesstep が作っている JetBrains IDE(2024.1 以降)のプラグインです。プルリクエストのコメントのスレッドを、IDE のツールウィンドウと差分の該当する行に出します。Bitbucket Cloud と、ベータ版として Bitbucket Data Center 8.9 以降に対応します。1.0.33 からは、行へのコメントの中の ```suggestion のブロックの上に、どの行を置き換えるのか(空なら消すこと)と、プルリクエストのページの「Apply suggestion」で取り込むことを書きます。1.0.34 からは、Data Center 9.3 以降の複数行の提案もそうなります。1.0.35 からは、プラグインの差分で複数の行を選んで書いたコメントが、Data Center 9.3 以降では選んだ行全体に付きます(それまでは最後の行だけ)。そこで書いた提案は、範囲全体を置き換えます。プラグイン自身は提案を取り込みません。レビューの受け箱・差分・議論・マージチェックは無料、承認・コメント・マージは Pro(月 US$1.50・30日間の無料試用つき)です。画面は日本語です。
Bitbucket と Atlassian は Atlassian の商標、IntelliJ IDEA は JetBrains s.r.o. の商標です。このページは Atlassian・JetBrains のいずれとも提携しておらず、承認も受けていません。
ほかに:Rovo Dev のコードレビュー · 自分のレビュー待ちを全部見つける · Bitbucket のマージチェック · pre-receive hook declined · IntelliJ IDEA で使える Bitbucket のプルリクエストのプラグインの比較 · English