Skip to main content

pull request の作成

リポジトリ内のコードに対する変更を提案するプル要求を作成します。

この機能を使用できるユーザーについて

Anyone with read access to a repository can create a pull request.

pull request の新しいブランチを作成するが、リポジトリへの書き込みアクセス許可がない場合は、まずリポジトリをフォークできます。 「Creating a pull request from a fork」と「フォーク」を参照してください。

pull request を作成するときに、変更をマージするブランチを指定できます。 プル要求は、2 つの異なるブランチ間でのみ開くことができます。

メモ

パブリック リポジトリの pull request を開くには、ヘッドまたはソース ブランチへの書き込みアクセス権が必要です。または、organization が所有するリポジトリの場合は、pull request を開くリポジトリを所有する organization のメンバーである必要があります。

プル要求を問題にリンクして、修正プログラムが進行中であることを示し、pull request がマージされたときに問題を自動的に閉じます。 詳しくは、「プルリクエストを課題にリンクする」をご覧ください。

プルリクエストの作成

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. [Branch] メニューで、自分のコミットが含まれるブランチを選択します。

    リポジトリのメイン ページにあるブランチ ドロップダウン メニューのスクリーンショット。

  3. ファイルの一覧の上にある黄色のバナーで、 [比較と pull request] をクリックして、関連付けられているブランチの pull request を作成します。

    ファイルの一覧の上にあるバナーのスクリーンショット。

  4. _基本_ブランチドロップダウン メニューを使用して、変更をマージするブランチを選択します。 次に、[ ブランチの比較 ] ドロップダウン メニューを使用して、変更を行ったトピック ブランチを選択します。

  5. プルリクエストのタイトルと説明を入力します。

  6. レビューの準備が完了している pull request を作成するには、 [pull request の作成] をクリックします。 ドラフトの pull request を作成するには、ドロップダウンを使用して、 [ドラフトの pull request の作成] を選択し、 [ドラフトの pull request] をクリックします。 組織のメンバーである場合は、組織の所有者から下書きプル要求へのアクセスを要求することが必要になることがあります。 「Pull Request」をご覧ください。

ヒント

pull request を作成したら、提案された変更のレビューを特定の人に依頼できます。 詳しくは、「プルリクエストレビューを依頼する」をご覧ください。

pull request が確認されたら、リポジトリにマージできます。 「Merging a pull request」を参照してください。

メモ

GitHub CLI の詳細については、「GitHub CLI について」を参照してください。

pull request を作成するには、gh pr create サブコマンドを使用します。

gh pr create

pull request を個人に割り当てるには、--assignee または -a フラグを使用します。 pull request を自己割り当てするために @me を使用できます。

gh pr create --assignee "@octocat"

pull request をマージするブランチを指定するには、--base または -B フラグを使用します。 pull request のコミットを含むブランチを指定するには、--head または -H フラグを使用します。

gh pr create --base my-base-branch --head my-changed-branch

新しい pull request のタイトルと本文を含めるには、--title--body フラグを使用します。

gh pr create --title "The bug is fixed" --body "Everything works again"

pull request をドラフトとしてマークするには、--draft フラグを使用します。

gh pr create --draft

新しいプル要求にラベルまたはマイルストーンを追加するには、 --label フラグと --milestone フラグを使用します。

gh pr create --label "bug,help wanted" --milestone octocat-milestone

特定のプロジェクトに新しい pull request を追加するには、--project フラグを使用します。

gh pr create --project octocat-project

個人またはチームをレビュー担当者として割り当てるには、--reviewer フラグを使用します。

gh pr create --reviewer monalisa,hubot --reviewer myorg/team-name

既定の Web ブラウザーで pull request を作成するには、--web フラグを使用します。

gh pr create --web
  1. [pull request をプレビューする] をクリックします。 GitHub Desktop は、現在のブランチとベース ブランチの間の変更の相違を示すプレビュー ダイアログを開きます。

    または、プル要求を作成する GitHub に直接移動するには、ドロップダウン アイコンを選択し、[ Pull Request の作成] をクリックします。

  2. [base:] ドロップダウン メニューのブランチが、変更をマージするブランチであることを確認します。

    [pull request を開く] ダイアログ ウィンドウのスクリーンショット。 [base: development] というラベルが付いたドロップダウン アイコンが表示されているボタンがオレンジ色の枠線で囲まれています。

GitHub Desktop は、現在のブランチをベース ブランチに自動的にマージできるかどうかを示します。

[pull request を開く] ダイアログ ウィンドウのスクリーンショット。 [自動的に結合できない] という状態ラベルがオレンジ色の枠線で強調表示されています。

  1. [pull request の作成] をクリックします。 GitHub Desktop は既定のブラウザーを開き、 GitHubに移動します。
  2. プルリクエストのタイトルと説明を入力します。
  3. レビューの準備が完了している pull request を作成するには、 [pull request の作成] をクリックします。 ドラフトの pull request を作成するには、ドロップダウンを使用して、 [ドラフトの pull request の作成] を選択し、 [ドラフトの pull request] をクリックします。 組織のメンバーである場合は、組織の所有者から下書きプル要求へのアクセスを要求することが必要になることがあります。 「Pull Request」をご覧ください。
  1. リポジトリのローカル コピーに変更をコミットしたら、[ プル要求の作成 ] アイコンをクリックします。

[ソース管理] サイド バーの上部のスクリーンショット。 pull request アイコンが濃いオレンジ色の枠線で強調表示されています。

  1. マージ元のローカルブランチとリポジトリ、およびマージ先のリモートブランチとリポジトリが正しいことを確認します。 次に、pull request にタイトルと説明を付けます。

[GitHub pull request] サイド バーと pull request を作成するフォームのスクリーンショット。[タイトル] と [説明] のフィールドが表示されています。

  1. Create をクリックしてください。

GitHub Codespacesでのプル要求の作成の詳細については、pull request に GitHub Codespaces を使用する を参照してください。

pull request 内のファイルに変更を加える

pull request を開いた後は、ヘッド ブランチに新しいコミットを追加することで、ファイルの変更を続行できます。

GitHub Web サイトでファイルを変更することもできます。

  1. GitHubで、リポジトリ内のプル要求に移動します。

  2. Pull request で、[ Files changed] をクリックします。

    pull request のタブのスクリーンショット。 [変更されたファイル] タブが濃いオレンジ色の枠線で囲まれています。

  3. 変更するファイルまで下にスクロールします。

    • pull request に多くのファイルがある場合は、フィルターを使用してファイルを見つけることができます。
  4. 変更するファイルの上にある [ ] をクリックします。

[File changed] タブのファイルの上にあるオプションのスクリーンショット。[Show options] ボタンがオレンジ色の四角形で強調されています。

  1. メニューで [Edit file] をクリックします。
  2. エディターで変更を加えます。 変更をコミットするときは、ヘッド ブランチに直接コミットすることを選択します。

詳細については、次を参照してください。