InfoGrab Docs

머지 리퀘스트의 변경 사항

요약

머지 리퀘스트는 리포지터리의 브랜치에 있는 파일에 대한 변경 사항 세트를 제안합니다. 이 예시는 텍스트 파일의 변경 사항을 보여줍니다. diff에는 파일 왼쪽의 여백에 탐색 및 댓글 도구도 포함됩니다: 파일 브라우저를 사용하여 머지 리퀘스트에서 변경된 파일 목록을 확인합니다:

머지 리퀘스트는 리포지터리의 브랜치에 있는 파일에 대한 변경 사항 세트를 제안합니다. GitLab은 이러한 변경 사항을 현재 상태와 제안된 변경 사항 간의 diff(차이)로 표시합니다. 기본적으로 diff는 제안된 변경 사항(소스 브랜치)을 대상 브랜치와 비교합니다. 기본적으로 GitLab은 파일의 변경된 부분만 표시합니다.

이 예시는 텍스트 파일의 변경 사항을 보여줍니다. 기본 구문 강조 테마에서:

  • 현재 버전은 빨간색으로 표시되며 줄 앞에 빼기(-) 기호가 있습니다.
  • 제안된 버전은 녹색으로 표시되며 줄 앞에 더하기(+) 기호가 있습니다.

추가 및 제거된 코드 줄을 보여주는 머지 리퀘스트 diff.

diff의 각 파일 헤더에는:

  • 파일 내용 숨기기 ([chevron-down]) 이 파일의 모든 변경 사항을 숨깁니다.
  • 경로: 이 파일의 전체 경로. 이 경로를 복사하려면 파일 경로 복사 ([copy-to-clipboard])를 선택합니다.
  • 변경된 줄: 이 파일에서 추가 및 제거된 줄 수로, +2 -2 형식으로 표시됩니다.
  • 확인: 이 체크박스를 선택하면 변경될 때까지 파일을 확인된 것으로 표시합니다.
  • 이 파일에 댓글 추가 ([comment]) 특정 줄에 고정하지 않고 파일에 일반 댓글을 남깁니다.
  • 옵션: (⋮)를 선택하면 더 많은 파일 보기 옵션이 표시됩니다.

diff에는 파일 왼쪽의 여백에 탐색 및 댓글 도구도 포함됩니다:

  • 더 많은 컨텍스트 표시: 이전 20줄 ([expand-up])을 선택하여 이전 20개의 변경되지 않은 줄을 표시하거나 다음 20줄 ([expand-down])을 선택하여 다음 20개의 변경되지 않은 줄을 표시합니다.
  • 줄 번호는 두 열로 표시됩니다. 이전 줄 번호는 왼쪽에 표시되고 제안된 줄 번호는 오른쪽에 표시됩니다. 줄과 상호작용하려면:
    • 댓글 옵션을 표시하려면 줄 번호 위에 마우스를 올립니다.
    • 줄 링크를 복사하려면 Command를 누르고 줄 번호를 선택(또는 오른쪽 클릭)한 다음 링크 주소 복사를 선택합니다.
    • 줄을 강조 표시하려면 줄 번호를 선택합니다.

변경된 파일 목록 표시#

파일 브라우저를 사용하여 머지 리퀘스트에서 변경된 파일 목록을 확인합니다:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.
  4. 파일 브라우저 표시 ([file-tree])를 선택하거나 F를 눌러 파일 트리를 표시합니다.
    • 중첩을 보여주는 트리 보기를 위해 트리 보기 ([file-tree])를 선택합니다.
    • 중첩 없는 파일 목록을 위해 목록 보기 ([list-bulleted])를 선택합니다.

머지 리퀘스트의 모든 변경 사항 표시#

머지 리퀘스트에 포함된 변경 사항의 diff를 보려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.
  4. 머지 리퀘스트가 많은 파일을 변경하는 경우 특정 파일로 직접 이동할 수 있습니다:
    1. 파일 브라우저 표시 ([file-tree])를 선택하거나 F를 눌러 파일 트리를 표시합니다.
    2. 보려는 파일을 선택합니다.
    3. 파일 브라우저를 숨기려면 파일 브라우저 표시를 선택하거나 F를 다시 누릅니다.

GitLab은 성능 향상을 위해 많은 변경 사항이 있는 파일을 축소하고 메시지를 표시합니다: 일부 변경 사항이 표시되지 않습니다. 해당 파일의 변경 사항을 보려면 파일 확장을 선택합니다.

연결된 파일을 먼저 표시#

히스토리
  • GitLab 16.9에서 pinned_file이라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 17.4에서 일반 사용 가능. 기능 플래그 pinned_file이 제거되었습니다.

팀원과 머지 리퀘스트 링크를 공유할 때 변경된 파일 목록에서 특정 파일을 먼저 표시하고 싶을 수 있습니다. 원하는 파일을 먼저 표시하는 머지 리퀘스트 링크를 복사하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.

  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.

  4. 먼저 표시할 파일을 찾습니다. 파일 이름을 오른쪽 클릭하여 링크를 복사합니다.

  5. 해당 링크를 방문하면 선택한 파일이 목록 맨 위에 표시됩니다. 파일 브라우저에는 파일 이름 옆에 링크 아이콘([link])이 표시됩니다:

    YAML 파일이 맨 위에 있는 파일 목록을 보여주는 머지 리퀘스트.

생성된 파일 축소#

히스토리

검토자가 코드 리뷰를 수행하는 데 필요한 파일에 집중할 수 있도록 GitLab은 몇 가지 일반적인 유형의 생성된 파일을 축소합니다. GitLab은 이러한 파일을 기본적으로 축소하는데, 코드 리뷰가 거의 필요하지 않기 때문입니다:

  1. .nib, .xcworkspacedata, 또는 .xcurserstate 확장자를 가진 파일.
  2. package-lock.json 또는 Gopkg.lock과 같은 패키지 잠금 파일.
  3. node_modules 폴더의 파일.
  4. 축소된 js 또는 css 파일.
  5. 소스 맵 참조 파일.
  6. 프로토콜 버퍼 컴파일러가 생성한 파일을 포함한 생성된 Go 파일.

파일이나 경로를 생성된 것으로 표시하려면 .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. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.
  4. 기본 설정 ([preferences])을 선택합니다.
  5. 한 번에 하나의 파일 표시를 선택하거나 해제합니다.
  1. 오른쪽 상단 모서리에서 아바타를 선택합니다.
  2. 기본 설정을 선택합니다.
  3. 동작 섹션으로 스크롤하여 머지 리퀘스트 변경 탭에서 한 번에 하나의 파일 표시 체크박스를 선택합니다.
  4. 변경사항 저장을 선택합니다.

이 설정이 활성화된 상태에서 볼 다른 파일을 선택하려면:

  • 파일 끝으로 스크롤하여 이전 또는 다음을 선택합니다.
  • 키보드 단축키가 활성화된 경우, [, ], k, 또는 j를 누릅니다.
  • 파일 브라우저 표시 ([file-tree])를 선택하고 볼 다른 파일을 선택합니다.

변경 사항 비교#

머지 리퀘스트의 변경 사항을 다음 방식으로 볼 수 있습니다:

  • 인라인으로, 변경 사항을 수직으로 표시합니다. 이전 버전의 줄이 먼저 표시되고 새 버전이 바로 아래에 표시됩니다. 인라인 모드는 단일 줄 변경에 더 좋은 경우가 많습니다.
  • 나란히, 이전 및 새 버전의 줄을 별도의 열로 표시합니다. 나란히 모드는 많은 수의 연속 줄에 영향을 미치는 변경에 더 좋은 경우가 많습니다.

머지 리퀘스트가 변경된 줄을 표시하는 방식을 변경하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.

  3. 제목 아래에서 변경 사항을 선택합니다.

  4. 기본 설정 ([preferences])을 선택합니다. 나란히 또는 인라인을 선택합니다. 이 예시는 GitLab이 인라인 및 나란히 모드 모두에서 동일한 변경을 렌더링하는 방식을 보여줍니다:

인라인 모드의 머지 리퀘스트 코드 변경 사항.

나란히 모드의 머지 리퀘스트 코드 변경 사항.

Rapid Diffs#

히스토리

Rapid Diffs는 베타 버전입니다. 클래식 diff 경험의 일부 기능은 아직 제공되지 않습니다. 알려진 제한 사항 목록은 피드백 이슈 596236을 참조하세요. 기능 동등성 로드맵은 에픽 19380을 참조하세요.

Rapid Diffs는 머지 리퀘스트에서 코드 변경 사항을 더 빠르게 로드하고 상호작용하는 방법입니다. diff를 검토할 때 첫 번째 파일이 표시되는 시간을 단축합니다.

Rapid Diffs 켜기#

모든 머지 리퀘스트에 대해 Rapid Diffs를 켜려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.
  4. Rapid Diffs 사용해보기를 선택합니다.

페이지가 새 경험으로 다시 로드됩니다. 이 기본 설정은 세션 간에 유지됩니다.

Rapid Diffs에 대한 피드백을 공유하려면 Rapid Diffs > 피드백 남기기를 선택합니다.

Rapid Diffs 끄기#

Rapid Diffs를 끄고 기존 diff 로딩 경험으로 되돌아가려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.
  4. Rapid Diffs를 선택하여 드롭다운 목록을 엽니다.
  5. 클래식 로딩으로 전환을 선택합니다.

머지 리퀘스트에서 코드 설명#

모델 정보
히스토리

다른 사람이 만든 코드를 이해하는 데 많은 시간을 보내거나 익숙하지 않은 언어로 작성된 코드를 이해하는 데 어려움을 겪는 경우 GitLab Duo에게 코드를 설명해달라고 요청할 수 있습니다.

사전 요구사항:

머지 리퀘스트에서 코드를 설명하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택한 다음 머지 리퀘스트를 선택합니다.

  3. 변경 사항을 선택합니다.

  4. 설명을 원하는 파일에서 세 점(⋮)을 선택하고 $SHA에서 파일 보기를 선택합니다.

    최신 변경 사항이 포함된 전체 파일을 보여주는 별도의 브라우저 탭이 열립니다.

  5. 새 탭에서 설명을 원하는 줄을 선택합니다.

  6. 왼쪽에서 물음표([question])를 선택합니다. 선택 항목의 첫 번째 줄로 스크롤해야 볼 수 있을 수도 있습니다.

    머지 리퀘스트에서 GitLab Duo를 사용하여 선택한 코드 스니펫을 설명하는 아이콘.

GitLab Duo Chat이 코드를 설명합니다. 설명이 생성되는 데 잠시 시간이 걸릴 수 있습니다.

원하는 경우 설명의 품질에 대한 피드백을 제공할 수 있습니다.

GitLab은 대규모 언어 모델이 올바른 결과를 생성한다는 것을 보장할 수 없습니다. 설명을 주의해서 사용하십시오.

다음에서도 코드를 설명할 수 있습니다:

댓글 확장 또는 축소#

코드 변경 사항을 검토할 때 인라인 댓글을 숨길 수 있습니다:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 제목 아래에서 변경 사항을 선택합니다.
  4. 숨기려는 댓글이 있는 파일로 스크롤합니다.
  5. 댓글이 연결된 줄로 스크롤합니다. 여백에서 축소 ([collapse])를 선택합니다: 머지 리퀘스트 diff에서 댓글을 축소하는 아이콘.

인라인 댓글을 확장하고 다시 표시하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 제목 아래에서 변경 사항을 선택합니다.
  4. 표시하려는 축소된 댓글이 있는 파일로 스크롤합니다.
  5. 댓글이 연결된 줄로 스크롤합니다. 여백에서 사용자 아바타를 선택합니다: 머지 리퀘스트 diff에서 댓글을 확장하는 아이콘.

공백 변경 사항 무시#

공백 변경 사항은 머지 리퀘스트에서 실질적인 변경 사항을 보기 어렵게 만들 수 있습니다. 공백 변경 사항을 숨기거나 표시하도록 선택할 수 있습니다:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.

  3. 제목 아래에서 변경 사항을 선택합니다.

  4. 변경된 파일 목록 앞에서 기본 설정 ([preferences])을 선택합니다.

  5. 공백 변경 사항 표시를 선택하거나 해제합니다:

    기본 설정 메뉴가 확장되고 '공백 변경 사항 표시' 옵션이 선택된 머지 리퀘스트 diff.

파일을 확인된 것으로 표시#

여러 파일이 있는 머지 리퀘스트를 여러 번 검토할 때 이미 검토한 파일을 무시할 수 있습니다. 마지막 검토 이후 변경되지 않은 파일을 숨기려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 제목 아래에서 변경 사항을 선택합니다.
  4. 파일의 헤더에서 확인 체크박스를 선택합니다.

다음 중 하나에 해당하지 않는 한 확인된 것으로 표시된 파일은 다시 표시되지 않습니다:

diff에서 머지 리퀘스트 충돌 표시#

대상 브랜치에 이미 있는 변경 사항을 표시하지 않기 위해 GitLab은 머지 리퀘스트의 소스 브랜치를 대상 브랜치의 HEAD와 비교합니다.

소스 브랜치와 대상 브랜치가 충돌하는 경우 GitLab은 머지 리퀘스트 diff의 충돌하는 각 파일에 대해 알림을 표시합니다:

머지 리퀘스트 diff의 충돌 알림.

diff에서 스캐너 결과 표시#

diff에서 스캐너 결과를 표시할 수 있습니다. 자세한 내용은:

머지 리퀘스트 변경 사항 다운로드#

GitLab 외부에서 사용하기 위해 머지 리퀘스트에 포함된 변경 사항을 다운로드할 수 있습니다.

diff로 다운로드#

변경 사항을 diff로 다운로드하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트를 선택합니다.
  4. 오른쪽 상단 모서리에서 코드 > 일반 diff를 선택합니다.

머지 리퀘스트의 URL을 알고 있는 경우 URL에 .diff를 추가하여 명령줄에서 diff를 다운로드할 수도 있습니다. 이 예시는 머지 리퀘스트 000000의 diff를 다운로드합니다:

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

한 줄 CLI 명령으로 diff를 다운로드하고 적용하려면:

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를 참조하십시오.

이전 diff 버전 다운로드#

히스토리

이전 diff 버전을 패치 또는 diff 파일로 다운로드하려면:

  1. 다운로드할 diff 버전을 비교합니다.
  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

머지 리퀘스트 파일에 댓글 추가#

히스토리

머지 리퀘스트 diff 파일에 댓글을 추가할 수 있습니다. 이 댓글은 리베이스 및 파일 변경 사항에도 유지됩니다.

머지 리퀘스트 파일에 댓글을 추가하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 변경 사항을 선택합니다.
  4. 댓글을 달려는 파일의 헤더에서 이 파일에 댓글 추가 ([comment])를 선택합니다.

이미지에 댓글 추가#

머지 리퀘스트와 커밋 세부 정보 보기에서 이미지에 댓글을 추가할 수 있습니다. 이 댓글은 스레드가 될 수도 있습니다.

  1. 이미지 위에 마우스를 올립니다.
  2. 댓글을 달려는 위치를 선택합니다.

GitLab은 이미지에 아이콘과 댓글 필드를 표시합니다.

관련 항목#

머지 리퀘스트의 변경 사항

Tier: Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기
요약

머지 리퀘스트는 리포지터리의 브랜치에 있는 파일에 대한 변경 사항 세트를 제안합니다. 이 예시는 텍스트 파일의 변경 사항을 보여줍니다. diff에는 파일 왼쪽의 여백에 탐색 및 댓글 도구도 포함됩니다: 파일 브라우저를 사용하여 머지 리퀘스트에서 변경된 파일 목록을 확인합니다:

머지 리퀘스트는 리포지터리의 브랜치에 있는 파일에 대한 변경 사항 세트를 제안합니다. GitLab은 이러한 변경 사항을 현재 상태와 제안된 변경 사항 간의 diff(차이)로 표시합니다. 기본적으로 diff는 제안된 변경 사항(소스 브랜치)을 대상 브랜치와 비교합니다. 기본적으로 GitLab은 파일의 변경된 부분만 표시합니다.

이 예시는 텍스트 파일의 변경 사항을 보여줍니다. 기본 구문 강조 테마에서:

  • 현재 버전은 빨간색으로 표시되며 줄 앞에 빼기(-) 기호가 있습니다.
  • 제안된 버전은 녹색으로 표시되며 줄 앞에 더하기(+) 기호가 있습니다.

추가 및 제거된 코드 줄을 보여주는 머지 리퀘스트 diff.

diff의 각 파일 헤더에는:

  • 파일 내용 숨기기 ([chevron-down]) 이 파일의 모든 변경 사항을 숨깁니다.
  • 경로: 이 파일의 전체 경로. 이 경로를 복사하려면 파일 경로 복사 ([copy-to-clipboard])를 선택합니다.
  • 변경된 줄: 이 파일에서 추가 및 제거된 줄 수로, +2 -2 형식으로 표시됩니다.
  • 확인: 이 체크박스를 선택하면 변경될 때까지 파일을 확인된 것으로 표시합니다.
  • 이 파일에 댓글 추가 ([comment]) 특정 줄에 고정하지 않고 파일에 일반 댓글을 남깁니다.
  • 옵션: (⋮)를 선택하면 더 많은 파일 보기 옵션이 표시됩니다.

diff에는 파일 왼쪽의 여백에 탐색 및 댓글 도구도 포함됩니다:

  • 더 많은 컨텍스트 표시: 이전 20줄 ([expand-up])을 선택하여 이전 20개의 변경되지 않은 줄을 표시하거나 다음 20줄 ([expand-down])을 선택하여 다음 20개의 변경되지 않은 줄을 표시합니다.
  • 줄 번호는 두 열로 표시됩니다. 이전 줄 번호는 왼쪽에 표시되고 제안된 줄 번호는 오른쪽에 표시됩니다. 줄과 상호작용하려면:
    • 댓글 옵션을 표시하려면 줄 번호 위에 마우스를 올립니다.
    • 줄 링크를 복사하려면 Command를 누르고 줄 번호를 선택(또는 오른쪽 클릭)한 다음 링크 주소 복사를 선택합니다.
    • 줄을 강조 표시하려면 줄 번호를 선택합니다.

변경된 파일 목록 표시#

파일 브라우저를 사용하여 머지 리퀘스트에서 변경된 파일 목록을 확인합니다:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.
  4. 파일 브라우저 표시 ([file-tree])를 선택하거나 F를 눌러 파일 트리를 표시합니다.
    • 중첩을 보여주는 트리 보기를 위해 트리 보기 ([file-tree])를 선택합니다.
    • 중첩 없는 파일 목록을 위해 목록 보기 ([list-bulleted])를 선택합니다.

머지 리퀘스트의 모든 변경 사항 표시#

머지 리퀘스트에 포함된 변경 사항의 diff를 보려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.
  4. 머지 리퀘스트가 많은 파일을 변경하는 경우 특정 파일로 직접 이동할 수 있습니다:
    1. 파일 브라우저 표시 ([file-tree])를 선택하거나 F를 눌러 파일 트리를 표시합니다.
    2. 보려는 파일을 선택합니다.
    3. 파일 브라우저를 숨기려면 파일 브라우저 표시를 선택하거나 F를 다시 누릅니다.

GitLab은 성능 향상을 위해 많은 변경 사항이 있는 파일을 축소하고 메시지를 표시합니다: 일부 변경 사항이 표시되지 않습니다. 해당 파일의 변경 사항을 보려면 파일 확장을 선택합니다.

연결된 파일을 먼저 표시#

히스토리
  • GitLab 16.9에서 pinned_file이라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 17.4에서 일반 사용 가능. 기능 플래그 pinned_file이 제거되었습니다.

팀원과 머지 리퀘스트 링크를 공유할 때 변경된 파일 목록에서 특정 파일을 먼저 표시하고 싶을 수 있습니다. 원하는 파일을 먼저 표시하는 머지 리퀘스트 링크를 복사하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.

  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.

  4. 먼저 표시할 파일을 찾습니다. 파일 이름을 오른쪽 클릭하여 링크를 복사합니다.

  5. 해당 링크를 방문하면 선택한 파일이 목록 맨 위에 표시됩니다. 파일 브라우저에는 파일 이름 옆에 링크 아이콘([link])이 표시됩니다:

    YAML 파일이 맨 위에 있는 파일 목록을 보여주는 머지 리퀘스트.

생성된 파일 축소#

히스토리

검토자가 코드 리뷰를 수행하는 데 필요한 파일에 집중할 수 있도록 GitLab은 몇 가지 일반적인 유형의 생성된 파일을 축소합니다. GitLab은 이러한 파일을 기본적으로 축소하는데, 코드 리뷰가 거의 필요하지 않기 때문입니다:

  1. .nib, .xcworkspacedata, 또는 .xcurserstate 확장자를 가진 파일.
  2. package-lock.json 또는 Gopkg.lock과 같은 패키지 잠금 파일.
  3. node_modules 폴더의 파일.
  4. 축소된 js 또는 css 파일.
  5. 소스 맵 참조 파일.
  6. 프로토콜 버퍼 컴파일러가 생성한 파일을 포함한 생성된 Go 파일.

파일이나 경로를 생성된 것으로 표시하려면 .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. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.
  4. 기본 설정 ([preferences])을 선택합니다.
  5. 한 번에 하나의 파일 표시를 선택하거나 해제합니다.
  1. 오른쪽 상단 모서리에서 아바타를 선택합니다.
  2. 기본 설정을 선택합니다.
  3. 동작 섹션으로 스크롤하여 머지 리퀘스트 변경 탭에서 한 번에 하나의 파일 표시 체크박스를 선택합니다.
  4. 변경사항 저장을 선택합니다.

이 설정이 활성화된 상태에서 볼 다른 파일을 선택하려면:

  • 파일 끝으로 스크롤하여 이전 또는 다음을 선택합니다.
  • 키보드 단축키가 활성화된 경우, [, ], k, 또는 j를 누릅니다.
  • 파일 브라우저 표시 ([file-tree])를 선택하고 볼 다른 파일을 선택합니다.

변경 사항 비교#

머지 리퀘스트의 변경 사항을 다음 방식으로 볼 수 있습니다:

  • 인라인으로, 변경 사항을 수직으로 표시합니다. 이전 버전의 줄이 먼저 표시되고 새 버전이 바로 아래에 표시됩니다. 인라인 모드는 단일 줄 변경에 더 좋은 경우가 많습니다.
  • 나란히, 이전 및 새 버전의 줄을 별도의 열로 표시합니다. 나란히 모드는 많은 수의 연속 줄에 영향을 미치는 변경에 더 좋은 경우가 많습니다.

머지 리퀘스트가 변경된 줄을 표시하는 방식을 변경하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.

  3. 제목 아래에서 변경 사항을 선택합니다.

  4. 기본 설정 ([preferences])을 선택합니다. 나란히 또는 인라인을 선택합니다. 이 예시는 GitLab이 인라인 및 나란히 모드 모두에서 동일한 변경을 렌더링하는 방식을 보여줍니다:

인라인 모드의 머지 리퀘스트 코드 변경 사항.

나란히 모드의 머지 리퀘스트 코드 변경 사항.

Rapid Diffs#

히스토리

Rapid Diffs는 베타 버전입니다. 클래식 diff 경험의 일부 기능은 아직 제공되지 않습니다. 알려진 제한 사항 목록은 피드백 이슈 596236을 참조하세요. 기능 동등성 로드맵은 에픽 19380을 참조하세요.

Rapid Diffs는 머지 리퀘스트에서 코드 변경 사항을 더 빠르게 로드하고 상호작용하는 방법입니다. diff를 검토할 때 첫 번째 파일이 표시되는 시간을 단축합니다.

Rapid Diffs 켜기#

모든 머지 리퀘스트에 대해 Rapid Diffs를 켜려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.
  4. Rapid Diffs 사용해보기를 선택합니다.

페이지가 새 경험으로 다시 로드됩니다. 이 기본 설정은 세션 간에 유지됩니다.

Rapid Diffs에 대한 피드백을 공유하려면 Rapid Diffs > 피드백 남기기를 선택합니다.

Rapid Diffs 끄기#

Rapid Diffs를 끄고 기존 diff 로딩 경험으로 되돌아가려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트 제목 아래에서 변경 사항을 선택합니다.
  4. Rapid Diffs를 선택하여 드롭다운 목록을 엽니다.
  5. 클래식 로딩으로 전환을 선택합니다.

머지 리퀘스트에서 코드 설명#

모델 정보
히스토리

다른 사람이 만든 코드를 이해하는 데 많은 시간을 보내거나 익숙하지 않은 언어로 작성된 코드를 이해하는 데 어려움을 겪는 경우 GitLab Duo에게 코드를 설명해달라고 요청할 수 있습니다.

사전 요구사항:

머지 리퀘스트에서 코드를 설명하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택한 다음 머지 리퀘스트를 선택합니다.

  3. 변경 사항을 선택합니다.

  4. 설명을 원하는 파일에서 세 점(⋮)을 선택하고 $SHA에서 파일 보기를 선택합니다.

    최신 변경 사항이 포함된 전체 파일을 보여주는 별도의 브라우저 탭이 열립니다.

  5. 새 탭에서 설명을 원하는 줄을 선택합니다.

  6. 왼쪽에서 물음표([question])를 선택합니다. 선택 항목의 첫 번째 줄로 스크롤해야 볼 수 있을 수도 있습니다.

    머지 리퀘스트에서 GitLab Duo를 사용하여 선택한 코드 스니펫을 설명하는 아이콘.

GitLab Duo Chat이 코드를 설명합니다. 설명이 생성되는 데 잠시 시간이 걸릴 수 있습니다.

원하는 경우 설명의 품질에 대한 피드백을 제공할 수 있습니다.

GitLab은 대규모 언어 모델이 올바른 결과를 생성한다는 것을 보장할 수 없습니다. 설명을 주의해서 사용하십시오.

다음에서도 코드를 설명할 수 있습니다:

댓글 확장 또는 축소#

코드 변경 사항을 검토할 때 인라인 댓글을 숨길 수 있습니다:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 제목 아래에서 변경 사항을 선택합니다.
  4. 숨기려는 댓글이 있는 파일로 스크롤합니다.
  5. 댓글이 연결된 줄로 스크롤합니다. 여백에서 축소 ([collapse])를 선택합니다: 머지 리퀘스트 diff에서 댓글을 축소하는 아이콘.

인라인 댓글을 확장하고 다시 표시하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 제목 아래에서 변경 사항을 선택합니다.
  4. 표시하려는 축소된 댓글이 있는 파일로 스크롤합니다.
  5. 댓글이 연결된 줄로 스크롤합니다. 여백에서 사용자 아바타를 선택합니다: 머지 리퀘스트 diff에서 댓글을 확장하는 아이콘.

공백 변경 사항 무시#

공백 변경 사항은 머지 리퀘스트에서 실질적인 변경 사항을 보기 어렵게 만들 수 있습니다. 공백 변경 사항을 숨기거나 표시하도록 선택할 수 있습니다:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.

  3. 제목 아래에서 변경 사항을 선택합니다.

  4. 변경된 파일 목록 앞에서 기본 설정 ([preferences])을 선택합니다.

  5. 공백 변경 사항 표시를 선택하거나 해제합니다:

    기본 설정 메뉴가 확장되고 '공백 변경 사항 표시' 옵션이 선택된 머지 리퀘스트 diff.

파일을 확인된 것으로 표시#

여러 파일이 있는 머지 리퀘스트를 여러 번 검토할 때 이미 검토한 파일을 무시할 수 있습니다. 마지막 검토 이후 변경되지 않은 파일을 숨기려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 제목 아래에서 변경 사항을 선택합니다.
  4. 파일의 헤더에서 확인 체크박스를 선택합니다.

다음 중 하나에 해당하지 않는 한 확인된 것으로 표시된 파일은 다시 표시되지 않습니다:

diff에서 머지 리퀘스트 충돌 표시#

대상 브랜치에 이미 있는 변경 사항을 표시하지 않기 위해 GitLab은 머지 리퀘스트의 소스 브랜치를 대상 브랜치의 HEAD와 비교합니다.

소스 브랜치와 대상 브랜치가 충돌하는 경우 GitLab은 머지 리퀘스트 diff의 충돌하는 각 파일에 대해 알림을 표시합니다:

머지 리퀘스트 diff의 충돌 알림.

diff에서 스캐너 결과 표시#

diff에서 스캐너 결과를 표시할 수 있습니다. 자세한 내용은:

머지 리퀘스트 변경 사항 다운로드#

GitLab 외부에서 사용하기 위해 머지 리퀘스트에 포함된 변경 사항을 다운로드할 수 있습니다.

diff로 다운로드#

변경 사항을 diff로 다운로드하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 머지 리퀘스트를 선택합니다.
  4. 오른쪽 상단 모서리에서 코드 > 일반 diff를 선택합니다.

머지 리퀘스트의 URL을 알고 있는 경우 URL에 .diff를 추가하여 명령줄에서 diff를 다운로드할 수도 있습니다. 이 예시는 머지 리퀘스트 000000의 diff를 다운로드합니다:

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

한 줄 CLI 명령으로 diff를 다운로드하고 적용하려면:

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를 참조하십시오.

이전 diff 버전 다운로드#

히스토리

이전 diff 버전을 패치 또는 diff 파일로 다운로드하려면:

  1. 다운로드할 diff 버전을 비교합니다.
  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

머지 리퀘스트 파일에 댓글 추가#

히스토리

머지 리퀘스트 diff 파일에 댓글을 추가할 수 있습니다. 이 댓글은 리베이스 및 파일 변경 사항에도 유지됩니다.

머지 리퀘스트 파일에 댓글을 추가하려면:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 코드 > 머지 리퀘스트를 선택하고 머지 리퀘스트를 찾습니다.
  3. 변경 사항을 선택합니다.
  4. 댓글을 달려는 파일의 헤더에서 이 파일에 댓글 추가 ([comment])를 선택합니다.

이미지에 댓글 추가#

머지 리퀘스트와 커밋 세부 정보 보기에서 이미지에 댓글을 추가할 수 있습니다. 이 댓글은 스레드가 될 수도 있습니다.

  1. 이미지 위에 마우스를 올립니다.
  2. 댓글을 달려는 위치를 선택합니다.

GitLab은 이미지에 아이콘과 댓글 필드를 표시합니다.

관련 항목#