• 변경된 파일 목록 표시
• 병합 요청에 대한 모든 변경 사항 표시
  • 연결된 파일 먼저 표시
• 생성된 파일 축소
  • 축소된 파일 보기
  • 파일 유형에 대한 축소 동작 구성
• 파일당 하나의 파일 보기
• 변경 사항 비교
• 병합 요청에서 코드 설명하기
• 인라인 주석 확장 또는 축소
• 공백 변경 사항 무시
• 파일 보기로 표시하기
• 병합 요청에서 충돌 표시 보기
• 차이에 스캐너 결과 표시
• 병합 요청 파일에 주석 추가
• 이미지에 주석 추가
• 리소스

병합 요청의 변경 사항

병합 요청(Merge Request, MR)은 귀하의 저장소의 브랜치 내 파일에 대한 변경 내용 세트를 제안합니다. GitLab은 현재 상태와 제안된 변경 사항 사이의 차이를 diff (차이)로 표시합니다. 기본적으로 diff는 귀하의 제안된 변경 사항(소스 브랜치)을 대상 브랜치와 비교합니다. 기본적으로 GitLab은 파일의 변경된 부분만 표시합니다.

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

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

diff의 각 파일 헤더에는 다음이 포함됩니다:

• 파일 내용 숨기기 () - 이 파일에 대한 모든 변경 사항을 숨깁니다.
• 경로: 해당 파일의 전체 경로입니다. 이 경로를 복사하려면 파일 경로 복사 ()를 선택합니다.
• 변경된 줄: 이 파일에서 추가된 줄과 삭제된 줄의 수를 +2 -2 형식으로 표시합니다.
• 보기: 해당 확인란을 선택하여 파일을 본 것으로 표시합니다.
• 이 파일에 댓글 달기 () - 특정 줄에 고정하지 않고 파일에 대한 일반 코멘트를 남깁니다.
• 옵션: ()을 선택하여 더 많은 파일 보기 옵션을 표시합니다.

diff에는 또한 파일 왼쪽에 네비게이션 및 코멘트 보조도 포함됩니다:

• 더 많은 콘텍스트 표시: 이전 20줄 ()을 선택하여 이전 20줄의 변경되지 않은 부분을 표시하거나, 다음 20줄 ()을 선택하여 다음 20줄의 변경되지 않은 부분을 표시합니다.
• 줄 번호는 두 열로 표시됩니다. 이전 줄 번호는 왼쪽에 표시되고, 제안된 줄 번호는 오른쪽에 표시됩니다. 줄과 상호 작용하려면:
  • 코멘트 옵션을 표시하려면 줄 번호 위로 마우스를 올리세요.
  • 링크를 복사하려면 Command를 누른 후 (또는 마우스 오른쪽 버튼 클릭), 줄 번호를 선택한 후 링크 주소 복사를 선택하세요.
  • 줄을 강조하려면 줄 번호를 선택하세요.

변경된 파일 목록 표시

병합 요청에서 변경된 파일의 목록을 보려면 파일 브라우저를 사용하세요:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 귀하의 프로젝트를 찾으세요.
2. 코드 > 병합 요청을 선택하여 병합 요청을 찾으세요.
3. 병합 요청 제목 아래에서 변경 사항을 선택하세요.
4. 파일 브라우저 표시를 선택하거나 F를 눌러 파일 트리를 표시하세요.
   • 중첩을 표시하는 트리 보기를 원하면 트리 보기를 선택하세요 ().
   • 중첩되지 않은 파일 목록을 원하면 목록 보기를 선택하세요 ().

병합 요청에 대한 모든 변경 사항 표시

병합 요청에 포함된 변경 사항의 diff를 보려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 귀하의 프로젝트를 찾으세요.
2. 코드 > 병합 요청을 선택하여 병합 요청을 찾으세요.
3. 병합 요청 제목 아래에서 변경 사항을 선택하세요.
4. 병합 요청에서 많은 파일이 변경된 경우 특정 파일로 바로 이동할 수 있습니다:
   1. 파일 브라우저 표시를 선택하거나 F를 눌러 파일 트리를 표시하세요.
   2. 보고 싶은 파일을 선택하세요.
   3. 파일 브라우저를 숨기려면 다시 파일 브라우저 표시를 선택하거나 F를 누르세요.

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

연결된 파일 먼저 표시

• GitLab 16.9에 도입됨 - pinned_file이라는 플래그로
• GitLab 17.4에서 일반적으로 사용 가능. 기본 설정에서 비활성화됨.

팀원에게 병합 요청 링크를 공유할 때, 변경된 파일 목록에서 특정 파일을 먼저 표시하고자 할 수 있습니다. 원하는 파일이 먼저 표시되는 병합 요청 링크를 복사하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 귀하의 프로젝트를 찾으세요.
2. 코드 > 병합 요청을 선택하여 병합 요청을 찾으세요.
3. 병합 요청 제목 아래에서 변경 사항을 선택하세요.
4. 원하는 파일을 찾으세요. 파일 이름을 마우스 오른쪽 버튼으로 클릭하여 링크를 복사하세요.

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

   

생성된 파일 축소

• GitLab 16.8에서 도입됨 - collapse_generated_diff_files라는 플래그로
• GitLab 16.10에서 GitLab.com 및 자체 관리형에서 활성화됨.
• generated_file는 GitLab 16.11에서 일반적으로 사용 가능합니다. collapse_generated_diff_files 플래그가 제거됨.

코드 리뷰를 수행하는 데 필요한 파일에 집중할 수 있도록 기존 타입의 생성된 파일을 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. Code > 병합 요청를 선택하고 병합 요청을 찾습니다.
3. 병합 요청 제목 아래에서 변경 내용을 선택합니다.
4. 보고 싶은 파일을 찾아 파일 확장을 선택합니다.

파일 유형에 대한 축소 동작 구성

파일 유형의 기본 축소 동작을 변경하려면:

1. 프로젝트의 루트 디렉토리에 .gitattributes 파일이 없는 경우, 해당 이름의 빈 파일을 생성합니다.

2. 수정하려는 각 파일 유형에 대해 .gitattributes 파일에 파일 확장자와 원하는 동작을 선언하는 줄을 추가합니다:

   # 확장자가 .txt인 모든 파일 축소
   *.txt gitlab-generated
   
   # docs 디렉토리 내의 모든 파일 축소
   docs/** gitlab-generated
   
   # package-lock.json 축소하지 않음
   package-lock.json -gitlab-generated
   

3. 변경 사항을 기본 브랜치로 커밋, 푸시, 병합합니다.

이 변경사항이 기본 브랜치에 병합되고 나면, 프로젝트내 이 유형의 모든 파일이 병합 요청에서 이러한 동작을 사용합니다.

GitLab이 생성된 파일을 감지하는 기술적 세부 정보에 대한 자세한 내용은 go-enry 리포지토리에서 확인할 수 있습니다.

파일당 하나의 파일 보기

대규모 병합 요청의 경우 파일당 하나씩 검토할 수 있습니다. 이 설정은 사용자 환경 설정에서 변경하거나 병합 요청을 검토할 때 변경할 수 있습니다. 병합 요청에서 이 설정을 변경하면 사용자 설정도 업데이트됩니다.

이 설정이 활성화된 경우 다른 파일을 선택하려면 다음을 수행합니다:

• 파일 끝까지 스크롤하고 이전 또는 다음 중 하나를 선택합니다.
• 키보드 바로가기가 활성화된 경우, [, ], k, 또는 j를 누릅니다.
• 파일 브라우저 보기 ()를 선택하고 보고 싶은 다른 파일을 선택합니다.

변경 사항 비교

병합 요청에서 변경 사항을 다음과 같이 확인할 수 있습니다:

• 인라인으로 표시하면 변경 사항이 수직으로 표시됩니다. 먼저 줄의 이전 버전이 표시되고, 바로 아래에 새 버전이 표시됩니다. 인라인 모드는 단일 줄에 대한 변경에 적합합니다.
• 옆으로 나열하면 줄의 이전 버전과 새 버전이 별도 열에 표시됩니다. 옆으로 나열 모드는 연속된 많은 줄에 영향을 미치는 변경에 더 적합합니다.

병합 요청에서 변경된 줄을 표시하는 방법을 변경하려면:

1. 좌측 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. Code > 병합 요청를 선택하고 병합 요청을 찾습니다.
3. 제목 아래에서 변경 내용을 선택합니다.

4. 환경 설정 ()을 선택합니다. 옆으로 나열 또는 인라인 중 하나를 선택합니다. 다음 예는 GitLab이 같은 변경을 인라인 및 옆으로 나열 모드로 렌더링하는 방법을 보여줍니다:

   인라인 변경 사항

   

   옆으로 나열된 변경 사항

   

병합 요청에서 코드 설명하기

• GitLab 15.11에서 실험으로 도입됨.
• GitLab 16.8에서 일반 사용 가능해짐.

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

사전 요구 사항:

• 실험 및 베타 기능 설정이 활성화된 하나 이상의 그룹에 속해 있어야 합니다.
• 프로젝트를 볼 수 있는 권한이 있어야 합니다.

병합 요청에서 코드를 설명하려면:

1. 좌측 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
3. 변경 내용을 선택합니다.

4. 설명을 원하는 파일을 선택하고, 세 점 ()을 선택한 후 파일 보기 @ $SHA를 선택합니다.

   별도의 브라우저 탭이 열리고 최신 변경이 있는 파일이 표시됩니다.

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

6. 왼쪽에서 물음표 ()를 선택합니다. 처음 선택한 줄을 보려면 스크롤해야 할 수 있습니다.

   

Duo 챗이 코드를 설명합니다. 설명을 생성하는 데 시간이 걸릴 수 있습니다.

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

커다란 언어 모델이 올바른 결과를 생성할 것을 보장할 수는 없습니다. 설명을 사용할 때 주의하세요.

또한 다음 위치에서 코드를 설명할 수 있습니다:

• 파일에서.
• IDE에서.

인라인 주석 확장 또는 축소

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

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
3. 제목 아래에서 변경 사항을 선택합니다.
4. 주석을 숨기려는 파일이 있는 파일로 스크롤합니다.
5. 주석이 달린 줄로 스크롤하고 축소를 선택합니다 ():

인라인 주석을 확장하고 다시 표시하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
3. 제목 아래에서 변경 사항을 선택합니다.
4. 접힌 주석을 표시하려는 파일로 스크롤합니다.
5. 주석이 달린 줄로 스크롤하고 사용자 아바타를 선택합니다:

공백 변경 사항 무시

공백 변경 사항은 병합 요청에서 실질적인 변경 사항을 더 어렵게 볼 수 있습니다. 이러한 경우 공백 변경 사항을 숨기거나 표시할 수 있습니다:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
3. 제목 아래에서 변경 사항을 선택합니다.
4. 변경된 파일 목록 앞에서 기본 설정을 선택합니다 ().

5. 공백 변경 사항 표시를 선택하거나 선택하지 않습니다:

   

파일 보기로 표시하기

많은 파일을 여러 번 검토하는 병합 요청을 검토할 때 이미 검토한 파일을 무시할 수 있습니다. 마지막 검토 이후 변경되지 않은 파일을 숨깁니다:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
3. 제목 아래에서 변경 사항을 선택합니다.
4. 파일 헤더에서 보기 확인란을 선택합니다.

보기로 표시된 파일은 다시 표시되지 않습니다.

• 파일의 내용이 변경되는 경우
• 보기 확인란을 지우는 경우

병합 요청에서 충돌 표시 보기

• GitLab.com 및 Self-managed에서 활성화되었습니다: GitLab 15.7에서.
• GitLab 15.8에서 일반적으로 사용 가능합니다. display_merge_conflicts_in_diff 피쳐 플래그가 제거되었습니다.

대상 브랜치에 이미 있는 변경 사항을 표시하지 않으려면 병합 요청의 소스 브랜치를 대상 브랜치의 HEAD와 비교합니다.

소스와 대상 브랜치가 충돌하는 경우, 병합 요청 차이에서 각 충돌 파일마다 경고를 표시합니다:

차이에 스캐너 결과 표시

차이에 스캐너 결과를 표시할 수 있습니다. 자세한 내용은 다음을 참조하세요:

• 코드 품질 결과
• 정적 분석 결과

병합 요청 파일에 주석 추가

• GitLab 16.1에서 도입되었습니다. 기본적으로 활성화된 comment_on_files라는 플래그와 함께 도입되었습니다.
• GitLab 16.2에서 피쳐 플래그가 제거되었습니다.

병합 요청 차이 파일에 주석을 추가할 수 있습니다. 이러한 주석은 리베이스와 파일 변경 간에 계속됩니다.

병합 요청 파일에 주석을 추가하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
3. 변경 사항을 선택합니다.
4. 주석을 추가하려는 파일의 헤더에서 주석을 선택합니다 ().

이미지에 주석 추가

병합 요청 및 커밋 상세 보기에서 이미지에 주석을 추가할 수 있습니다. 이 주석은 스레드가 될 수도 있습니다.

1. 이미지 위로 마우스를 가져갑니다.
2. 주석을 추가하려는 위치를 선택합니다.

GitLab은 이미지 위에 아이콘과 주석 필드를 표시합니다.

리소스

• 두 리비전 간의 차이를 계산하는 GitLab의 기술적인 세부 정보는 차이 작업을 참조하세요.