正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

マージリクエストの変更

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

マージリクエストは、リポジトリ内のブランチにあるファイルに対する一連の変更を提案します。GitLabはこれらの変更を、現在の状態と提案された変更との_差分_（差異）として表示します。デフォルトでは、差分は提案された変更（ソースブランチ）とターゲットブランチを比較します。デフォルトでは、GitLabはファイルの変更された部分のみを表示します。

この例は、テキストファイルへの変更を示しています。デフォルトの構文ハイライトのテーマでは、次のようになっています。

  • _現在_のバージョンは赤で表示され、行の先頭にマイナス（-）記号が表示されます。
  • _提案_されたバージョンは緑色で表示され、行の先頭にプラス（+）記号が表示されます。

マージリクエスト差分は、追加および削除されたコード行を示しています。

差分の各ファイルのヘッダーには、次のものが含まれています。

  • ファイルの内容を非表示にする（ chevron-down ）: このファイルに対するすべての変更を非表示にします。
  • パス: このファイルへのフルパス。このパスをコピーするには、ファイルのパスをコピー（ copy-to-clipboard ）を選択します。
  • Lines changed: このファイルで追加および削除された行の数で、+2 -2の形式です。
  • 閲覧済み: このチェックボックスをオンにすると、ファイルが再度変更されるまでファイルが閲覧済みに設定されます。
  • このファイルにコメントする（ comment ）: 特定の行にコメントを固定せずに、ファイルに一般的なコメントを残します。
  • オプション: （ ellipsis_v ）を選択して、その他のファイル表示オプションを表示します。

差分には、ファイルの左側にあるナビゲーションとコメントの補助機能も含まれています（ガター内）。

  • コンテキストをさらに表示: 前の20行（ expand-up ）を選択すると、前の20行の変更されていない行が表示されます。次の20行（ expand-down ）を選択すると、次の20行の変更されていない行が表示されます。
  • 行番号は2つの列に表示されます。前の行番号は左側に、提案された行番号は右側に表示されます。行を操作するには、次の手順に従います。
    • コメントオプションを表示するには、行番号にカーソルを合わせます。
    • 行へのリンクをコピーするには、Commandを押しながら行番号を選択（または右クリック）し、リンクアドレスをコピーを選択します。
    • 行をハイライト表示するには、行番号を選択します。

変更されたファイルの一覧を表示する

ファイルブラウザを使用して、次の手順でマージリクエストで変更されたファイルの一覧を表示します。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。
  3. マージリクエストのタイトルの下にある変更を選択します。
  4. ファイルブラウザを表示（ file-tree ）を選択するか、Fを押してファイルツリーを表示します。
    • ネストを示すツリー表示の場合は、ツリービュー（ file-tree ）を選択します。
    • ネストなしのファイル一覧表示の場合は、リスト表示（ list-bulleted ）を選択します。

マージリクエスト内のすべての変更を表示する

マージリクエストに含まれる変更の差分を表示するには、次の手順に従います。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。
  3. マージリクエストのタイトルの下にある変更を選択します。
  4. マージリクエストで多数のファイルが変更された場合は、特定のファイルに直接ジャンプできます。
    1. ファイルブラウザを表示（ file-tree ）を選択するか、Fを押してファイルツリーを表示します。
    2. 表示するファイルを選択します。
    3. ファイルブラウザを非表示にするには、ファイルブラウザを表示を選択するか、もう一度Fを押します。

GitLabは、パフォーマンスを向上させるために、多くの変更を含むファイルを折りたたみ、次のメッセージを表示します。一部の変更は表示しません。そのファイルの変更を表示するには、ファイルを展開を選択します。

リンクされたファイルを最初に表示する

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com

マージリクエストのリンクをチームメンバーと共有するときに、変更されたファイルの一覧で特定のファイルを最初に表示したい場合があります。目的のファイルを最初に表示するマージリクエストリンクをコピーするには、次の手順に従います。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。

  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。

  3. マージリクエストのタイトルの下にある変更を選択します。

  4. 最初に表示するファイルを検索します。ファイル名を右クリックして、そのファイルへのリンクをコピーします。

  5. そのリンクにアクセスすると、選択したファイルが一覧の一番上に表示されます。ファイルブラウザには、ファイル名の横にリンクアイコン（ link ）が表示されます。

    選択されたYAMLファイルが上部に表示された、ファイルをリスト表示しているマージリクエスト。

生成されたファイルを折りたたむ

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

レビュー担当者がコードレビューの実行に必要なファイルに集中できるようにするため、GitLabはいくつかの一般的なタイプの生成済みファイルを折りたたみます。これらのファイルでコードレビューが必要となることはめったにありません。したがって、GitLabはデフォルトで折りたたんでいます。

  1. .nib、.xcworkspacedata、または.xcurserstateの拡張子を持つファイル。
  2. ロックファイルなどpackage-lock.jsonやGopkg.lockなどのパッケージロックファイル。
  3. node_modulesフォルダー内のファイル。
  4. 縮小されたjsまたはcssファイル。
  5. ソースマップ参照ファイル。
  6. プロトコルバッファコンパイラによって生成されたファイルを含む、生成されたファイル。

ファイルまたはパスを生成されたものとしてマークするには、.gitattributesファイルでそのgitlab-generated属性を設定します。

折りたたまれたファイルを表示する

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。
  3. マージリクエストのタイトルの下にある変更を選択します。
  4. 表示するファイルを検索し、ファイルを展開を選択します。

ファイルタイプの折りたたみ動作を設定する

ファイルタイプのデフォルトの折りたたみ動作を変更するには、次の手順に従います。

  1. .gitattributesファイルがプロジェクトのルートディレクトリに存在しない場合は、この名前で空のファイルを作成します。

  2. 変更するファイルタイプごとに、ファイル拡張子と目的の動作を宣言する行を次のように.gitattributesファイルに追加します。

    # Collapse all files with a .txt extension
*.txt gitlab-generated

# Collapse all files within the docs directory
docs/** gitlab-generated

# Do not collapse package-lock.json
package-lock.json -gitlab-generated

  3. 変更をコミット、プッシュ、マージしてデフォルトブランチに反映します。

変更がデフォルトブランチにマージされた後、プロジェクト内のこのタイプのすべてのファイルは、マージリクエストでこの動作を使用します。

GitLabが生成されたファイルを検出する方法に関する技術的な詳細については、go-enryリポジトリを参照してください。

一度に1つのファイルを表示する

大規模なマージリクエストの場合は、一度に1つのファイルを確認できます。この設定は、ユーザー設定で変更するか、マージリクエストをレビューするときに変更できます。マージリクエストでこの設定を変更すると、ユーザー設定も更新されます。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。

  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。

  3. マージリクエストのタイトルの下にある変更を選択します。

  4. 設定（ preferences ）を選択します。

  5. 一度に1つのファイルを表示を選択またはクリアします。

  1. 右上隅で、アバターを選択します。
  2. 設定を選択します。
  3. 動作セクションまでスクロールし、マージリクエストの変更タブに一度に1つのファイルを表示するチェックボックスをオンにします。
  4. 変更を保存を選択します。

この設定が有効になっているときに表示する別のファイルを選択するには、次のいずれかを行います。

  • ファイルの末尾までスクロールし、前へまたは次へのいずれかを選択します。
  • キーボードショートカットが有効になっている場合は、[、]、k、またはjを押します。
  • ファイルブラウザを表示（ file-tree ）を選択し、表示する別のファイルを選択します。

変更を比較する

マージリクエストの変更は、次のいずれかで表示できます。

  • インライン: 変更が縦に表示されます。行の古いバージョンが最初に表示され、そのすぐ下に新しいバージョンが表示されます。インラインモードは、多くの場合で単一行の変更に適しています。
  • 並べて表示: 行の古いバージョンと新しいバージョンが別々の列に表示されます。並べて表示モードは、多くの場合、多数の連続する行に対して影響のある変更に適しています。

マージリクエストで変更された行の表示方法を変更するには、次の手順に従います。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。

  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。

  3. タイトルの下にある変更を選択します。

  4. 設定（ preferences ）を選択します。並べて表示またはインラインのいずれかを選択します。この例は、GitLabが同じ変更をインラインモードと並べて表示モードの両方でどのようにレンダリングするかを示しています。

    インラインモードでのマージリクエストのコード変更。

    サイドバイサイドモードでのマージリクエストのコード変更。

マージリクエストでコードを説明する

  • プラン: Premium、Ultimate
  • アドオン: GitLab Duo ProまたはEnterprise、GitLab Duo with Amazon Q
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

他の人が作成したコードを理解するのに多くの時間を費やしている場合、またはなじみのない言語で書かれたコードを理解するのに苦労している場合は、GitLab Duoにコードの説明を依頼できます。

前提条件:

  • 実験的機能とベータ機能の設定が有効になっているグループに少なくとも1つ所属している必要があります。
  • プロジェクトを表示するためのアクセス権が必要です。

マージリクエストでコードを説明するには、次の手順に従います。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。

  2. 左サイドバーで、コード > マージリクエストを選択し、目的のマージリクエストを選択します。

  3. 変更を選択します。

  4. 説明するファイルで、3つのドット（ ellipsis_v ）を選択し、View File @ $SHAを選択します。

    別のタブが開き、最新の変更を含むフルファイルが表示されます。

  5. 新しいタブで、説明する行を選択します。

  6. 左側で、疑問符（ question ）を選択します。表示するには、選択した最初の行までスクロールする必要がある場合があります。

    マージリクエストでGitLab Duoを使用して選択したコードスニペットを説明するアイコン。

GitLab Duo Chatがコードを説明します。説明の生成には時間がかかる場合があります。

必要に応じて、説明の品質に関するフィードバックを提供できます。

GitLabは、大規模言語モデルが正しい結果を生成することを保証できません。生成された説明は、注意して使用してください。

次の場所でもコードを説明できます。

コメントを展開または折りたたむ

コードの変更をレビューするときに、インラインコメントを非表示にできます。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。
  3. タイトルの下にある変更を選択します。
  4. 非表示にするコメントが含まれているファイルまでスクロールします。
  5. コメントが添付されている行までスクロールします。ガターマージンで、折りたたむ（ collapse ）を選択します: マージリクエスト差分でコメントを折りたたむアイコン。

インラインコメントを展開して再度表示するには、次の手順に従います。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。
  3. タイトルの下にある変更を選択します。
  4. 表示する折りたたみまれたコメントが含まれているファイルまでスクロールします。
  5. コメントが添付されている行までスクロールします。ガターマージンで、ユーザーアバターを選択します: マージリクエスト差分でコメントを展開するアイコン。

ホワイトスペースの変更を無視する

ホワイトスペースの変更により、マージリクエストの実質的な変更が見えにくくなる可能性があります。ホワイトスペースの変更を非表示または表示するように選択できます。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。

  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。

  3. タイトルの下にある変更を選択します。

  4. 変更されたファイルの一覧の前に、設定（ preferences ）を選択します。

  5. ホワイトスペースの変更を表示するを選択またはクリアします。

    環境設定メニューが展開され、「ホワイトスペースの変更を表示する」オプションが選択されたマージリクエスト差分。

ファイルに閲覧済みマークを付ける

多数のファイルがあるマージリクエストを複数回レビューする際に、すでにレビュー済みのファイルは無視できます。最後のレビュー以降に変更されていないファイルを非表示にするには、次の手順に従います。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。
  3. タイトルの下にある変更を選択します。
  4. ファイルのヘッダーで、閲覧済みチェックボックスを選択します。

閲覧済みとしてマークされたファイルは、以下の場合を除き、再度表示されることはありません。

  • ファイルの内容が変更された場合。
  • 閲覧済みチェックボックスをオフにした場合。

差分にマージリクエストの競合を表示する

ターゲットブランチにすでに存在する変更が表示されないように、GitLabはマージリクエストのソースブランチをターゲットブランチのHEADと比較します。

ソースブランチとターゲットブランチが競合する場合、GitLabは競合するファイルごとにマージリクエスト差分にアラートを表示します:

マージリクエスト差分における競合アラート。

差分にスキャナーの発見を表示する

  • プラン: Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

差分にスキャナーの発見を表示できます。詳細については、以下を参照してください。

マージリクエストの変更をダウンロードする

マージリクエストに含まれる変更を、GitLabの外部で使用するためにダウンロードできます。

差分として

変更を差分としてダウンロードするには:

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。
  3. マージリクエストを選択します。
  4. 右上隅で、コード > テキスト差分を選択します。

マージリクエストのURLがわかっている場合は、URLに.diffを付加して、コマンドラインから差分をダウンロードすることもできます。この例では、マージリクエスト000000の差分をダウンロードします。

https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.diff

ワンラインCLIコマンドで差分をダウンロードして適用するには:

curl "https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.diff" | git apply

パッチファイルとして

変更をパッチファイルとしてダウンロードするには:

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。
  3. マージリクエストを選択します。
  4. 右上隅で、コード > パッチを選択します。

マージリクエストのURLがわかっている場合は、URLに.patchを付加して、コマンドラインからパッチをダウンロードすることもできます。この例では、マージリクエスト000000のパッチファイルをダウンロードします。

https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.patch

git amを使用してパッチをダウンロードして適用するには:

# Download and preview the patch
curl "https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.patch" > changes.patch
git apply --check changes.patch

# Apply the patch
git am changes.patch

単一のコマンドでパッチをダウンロードして適用することもできます:

curl "https://gitlab.com/gitlab-org/gitlab/-/merge_requests/000000.patch" | git am

git amは-p1オプションをデフォルトで使用します。詳細については、git-applyを参照してください。

以前の差分バージョンをダウンロードする

以前の差分バージョンをパッチまたは差分ファイルとしてダウンロードするには:

  1. ダウンロードしたい差分バージョンを比較します。
  2. URLパスに.diffまたは.patchを追加します。

例:

# As a diff file:
https://gitlab.com/gitlab-org/gitlab/-/merge_requests/123456/diffs.diff?diff_id=525410&start_sha=a1b2c3d4

# As a patch file:
https://gitlab.com/gitlab-org/gitlab/-/merge_requests/123456/diffs.patch?diff_id=525410&start_sha=a1b2c3d4

マージリクエストファイルにコメントを追加する

マージリクエストの差分ファイルにコメントを追加できます。これらのコメントは、リベースやファイルの変更後も保持されます。

マージリクエストファイルにコメントを追加するには、次の手順に従います。

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。
  3. 変更を選択します。
  4. コメントしたいファイルのヘッダーで、このファイルにコメントする（ comment ）を選択します。

画像にコメントを追加する

マージリクエストとコミットの詳細表示では、画像にコメントを追加できます。このコメントはスレッドにもなります。

  1. 画像の上にマウスカーソルを合わせます。
  2. コメントする場所を選択します。

GitLabは、画像にアイコンとコメントフィールドを表示します。