注釈: pull request における特別なキーワードは、pull request がリポジトリの_デフォルト_ブランチをターゲットするときに解釈されます。 ただし、PR のベースが_それ以外のブランチ_である場合、それらのキーワードは無視され、リンクは作成されません。PR のマージはこの issue に対して何の効果も持ちません。 キーワードの 1 つを使って pull request を issue にリンクする場合、PR が既定ブランチ上になければなりません。
リンクされたIssueとPull Requestについて
手動か、pull request の説明でサポートされているキーワードを使い、pull request に issue にリンクできます。
Pull Requestが対処するIssueにそのPull Requestをリンクすると、コラボレータは、誰かがそのIssueに取り組んでいることを確認できます。
リンクされたPull Requestをリポジトリのデフォルトブランチにマージすると、それにリンクされているIssueは自動的にクローズされます。 既定のブランチについて詳しくは、「デフォルトブランチを変更する」をご覧ください。
キーワードを使用してPull RequestをIssueにリンクする
pull request の説明またはコミットメッセージでサポートされているキーワードを使用して、pull request に issue にリンクできます。 pull request は、既定のブランチに存在する必要があります。
closeclosesclosedfixfixesfixedresolveresolvesresolved
他のPull RequestでPull Requestのコメントを参照するためにキーワードを使用すると、Pull Requestはリンクされます。 参照元の pull request をマージすると、参照先の pull request もクローズされます。
クローズするキーワードの構文は、IssueがPull Requestと同じリポジトリにあるかどうかによって異なります。
| リンクするIssue | 構文 | 例 |
|---|---|---|
| Issueが同じリポジトリにある | KEYWORD #ISSUE-NUMBER | Closes #10 |
| Issueが別のリポジトリにある | KEYWORD OWNER/REPOSITORY#ISSUE-NUMBER | Fixes octo-org/octo-repo#100 |
| 複数の Issue | Issueごとに完全な構文を使用 | Resolves #10, resolves #123, resolves octo-org/octo-repo#100 |
手動でリンクされた pull request のみを手動でリンク解除できます。 キーワードを使用してリンクした issue のリンクを解除するには、pull request の説明を編集してそのキーワードを削除する必要があります。
クローズするキーワードは、コミットメッセージでも使用できます。 デフォルトブランチにコミットをマージするとIssueはクローズされますが、そのコミットを含むPull Requestは、リンクされたPull Requestとしてリストされません。
Pull Request を Issue に Pull Request サイドバーを使用して手動でリンクする
リポジトリへの書き込み権限があるユーザーなら誰でも、Pull Request サイドバーから Pull Request を手動で Issue にリンクできます。
手動で1つのPull Requestごとに最大10個のIssueをリンクできます。 IssueとPull Requestは同じリポジトリになければなりません。
-
ご自分のエンタープライズ で、リポジトリのメイン ページへ移動します。
-
リポジトリ名の下にある [pull request] をクリックします。
![リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、[pull request] というラベルが付いたタブが濃いオレンジ色の枠線で囲まれています。](/web/20231124095457im_/https://docs.github.com/assets/cb-52309/images/help/repository/repo-tabs-pull-requests.png)
-
Pull Requestのリストで、IssueにリンクしたいPull Requestをクリックします。
-
右側のサイドバーで、 [開発] をクリックします。
![issue サイドバーのスクリーンショット。 [開発] が濃いオレンジ色の枠線で囲まれています。](/web/20231124095457im_/https://docs.github.com/assets/cb-28721/images/help/issues/development-menu.png)
-
Pull RequestにリンクするIssueをクリックします。
![リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、[pull request] というラベルが付いたタブが濃いオレンジ色の枠線で囲まれています。](/web/20231124095457im_/https://docs.github.com/assets/cb-52309/mw-1440/images/help/repository/repo-tabs-pull-requests.webp)
![issue サイドバーのスクリーンショット。 [開発] が濃いオレンジ色の枠線で囲まれています。](/web/20231124095457im_/https://docs.github.com/assets/cb-28721/mw-1440/images/help/issues/development-menu.webp)