Một commit lớn có thể chứa cả sửa nội dung, xóa file và đổi tên. Trước khi đọc từng hunk, danh sách tên kèm trạng thái giúp reviewer nhìn phạm vi thay đổi. git diff –name-status cung cấp lớp thông tin đó, còn –cached chọn phần đã stage.
Chọn đúng phía của diff
Chạy trong repo thử nghiệm và tạo vài thay đổi có chủ đích. Lệnh đầu xem phần chưa stage, lệnh thứ hai xem phần sắp commit và lệnh thứ ba kiểm tra khả năng nhận diện đổi tên.
git diff --name-status
git diff --cached --name-status
git diff --cached --name-status --find-renames
Các ký hiệu thường gặp gồm A cho thêm, M cho sửa, D cho xóa và R cho đổi tên khi Git nhận diện. Với đổi tên, đầu ra còn có mức tương đồng và hai đường dẫn. Việc nhận diện dựa trên diff và ngưỡng tương đồng, nên cách hiển thị có thể khác khi file vừa đổi tên vừa sửa nhiều.
Đối chiếu trước khi đọc nội dung
Kiểm tra danh sách staged có đúng những file của tác vụ không. Nếu một file chỉ xuất hiện ở diff chưa stage, phần mới nhất của nó chưa nằm trong commit thông thường. Một file có thể có thay đổi ở cả hai phía, vì vậy dùng git status –short để có bức tranh đầy đủ.
Khi thấy D, mở phần xóa và xác nhận không làm mất tài nguyên được tham chiếu. Khi thấy R, kiểm tra các import hoặc đường dẫn cấu hình liên quan. Danh sách trạng thái là bản đồ để chọn chỗ đọc, còn tính đúng vẫn cần xem patch và chạy kiểm tra.
Dùng trong script
Thêm -z nếu cần đọc bằng chương trình để tên file được phân tách bằng NUL theo định dạng phù hợp. Đừng giả định mọi bản ghi có đúng một tên file vì bản ghi đổi tên chứa đường dẫn nguồn và đích. Tạo fixture có tên chứa khoảng trắng và một lần đổi tên để kiểm tra parser.
–name-status chỉ trả các file nằm trong phạm vi diff đã chọn. File untracked chưa được thêm không tự xuất hiện trong diff mặc định. Nếu đóng gói bản phát hành cần chúng, kiểm tra git status và quy trình tạo tài nguyên riêng.
Hoàn tất review
Sau khi stage hoặc bỏ stage, chạy lại danh sách và mở git diff –cached cho những file quan trọng. Giữ phạm vi diff nhất quán giữa lệnh thống kê và lệnh đọc nội dung. Khi dùng trên CI, chọn rõ hai mốc commit thay vì dựa vào trạng thái working tree khác môi trường local.
Lệnh được đối chiếu với tài liệu Git và chỉ đọc trạng thái. Ví dụ không thay đổi index hoặc tự tạo commit.


