Git Diff 보기

AI 에이전트가 무엇을 바꿨는지 파일 단위, 줄 단위로 정확히 확인하세요.

AI 에이전트가 작성한 코드를 커밋하기 전에 diff를 꼭 확인하세요. 30초면 충분하고, 잘못되었거나 예상치 못한 변경이 그대로 배포되는 일을 막아 줍니다. Git Client는 모든 변경 사항을 색상으로 구분해 한눈에 보여 줍니다.

Diff 보기 열기

  1. Cmd+G(Mac) 또는 Ctrl+G(Windows/Linux)를 눌러 Git 패널을 엽니다
  2. 왼쪽 사이드바에 커밋되지 않은 변경 사항이 있는 모든 파일이 표시되며, 스테이징되지 않은 변경 사항은 아래쪽 영역에 나타납니다
  3. 파일 이름을 클릭하면 오른쪽에 해당 파일의 diff가 열립니다

diff 보기는 바로 열립니다. 별도의 단계는 필요 없습니다.

Git 시각적 변경 사항 diff 보기

Diff 읽는 방법

diff는 일반적인 색상 규칙을 따릅니다.

  • 초록색 줄 — 에이전트가 추가한 줄
  • 빨간색 줄 — 삭제되었거나 다른 내용으로 교체된 줄
  • 회색 줄 — 변경 부분 주변의 그대로인 컨텍스트(참고용으로 표시)

변경된 각 구간을 hunk라고 합니다. 파일의 여러 위치가 수정되었다면 한 파일에 hunk가 여러 개 있을 수 있습니다. 아래로 스크롤하면 모두 볼 수 있습니다.

왼쪽의 줄 번호는 원본 파일의 줄 번호이고, 오른쪽의 줄 번호는 새 파일의 줄 번호입니다.

Diff에서 코드로 바로 이동

더블 클릭하면 변경 사항을 에디터에서 엽니다.

  • 변경된 파일은 파일 목록, 폴더 트리, 커밋의 파일 목록, diff 헤더의 파일 이름 중 어디에서든 해당 파일이 에디터에서 열립니다.
  • diff 줄을 더블 클릭하면 정확히 그 줄에 커서가 놓인 상태로 파일이 열립니다. 추가된 줄과 변경 없는 줄은 각자의 줄로, 삭제된 줄은 지금 그 자리를 대신하는 줄로, hunk 헤더는 해당 hunk의 첫 번째 줄로 이동합니다.

통합 보기와 나란히 보기

두 가지 diff 레이아웃 중에서 전환할 수 있습니다.

  • 통합 보기(Unified view) — 추가와 삭제를 한 열에 번갈아 표시합니다. 순차적인 변경을 읽기에 편합니다.
  • 나란히 보기(Side-by-side view) — 왼쪽에 이전 파일, 오른쪽에 새 파일을 표시합니다. 큰 블록이 바뀌었을 때 변경 전후를 비교하기에 편합니다.

diff 패널 오른쪽 위의 보기 전환 버튼을 클릭하면 두 레이아웃을 오갈 수 있습니다.

Diff 뷰어

이미지 Diff

프로젝트에 이미지가 있고 에이전트가 PNG, JPG 등의 이미지 파일을 수정했다면, diff 패널에 변경 전/후 시각적 비교가 표시됩니다. 슬라이더를 드래그하면 새 이미지 아래에 있는 이전 이미지가 드러나므로, 의도하지 않은 디자인 변경을 잡아내는 데 유용합니다.

키보드 탐색

다음 단축키로 변경된 파일 사이를 빠르게 이동할 수 있습니다.

단축키동작
]다음 변경 파일로 이동
[이전 변경 파일로 이동
↓ / ↑diff 스크롤

]와 [로 파일을 넘기는 것이 사이드바에서 클릭하는 것보다 훨씬 빠릅니다. 에이전트가 한 번에 파일 열 개, 열다섯 개를 건드렸을 때 특히 그렇습니다.

커밋 전에 검토해야 하는 이유

AI 에이전트는 빠르고 대체로 정확하지만, 항상 그런 것은 아닙니다. diff를 검토할 때 흔히 확인해야 할 항목은 다음과 같습니다.

  • 삭제되면 안 되는 줄이 삭제됨 — 에이전트가 실수로 함수나 주석을 지웠을 수 있습니다
  • 요청하지 않은 파일이 변경됨 — 예상하지 못한 설정 파일이나 테스트 파일을 건드렸을 수 있습니다
  • 플레이스홀더 값 — TODO, your-api-key-here, 남겨 두려던 것이 아닌 하드코딩된 테스트 데이터

커밋하기 전에 diff를 빠르게 검토하면 Git 히스토리가 깔끔하게 유지되고 코드베이스도 항상 정상 상태로 유지됩니다. 또한 에이전트가 실제로 무엇을 했는지 이해하게 되어, 시간이 지날수록 더 나은 개발자가 될 수 있습니다.