Git grep: Tìm code đúng phiên bản trong working tree, staging và commit

Bạn tìm một tên hàm trong editor nhưng không thấy, trong khi đồng nghiệp nói nó có trong commit hiện tại. Có thể hai người đang tìm ở hai phiên bản khác nhau: file đang sửa, vùng staging hoặc nội dung đã commit. Git grep cho phép chọn rõ nguồn dữ liệu để tránh kết luận quá sớm.

1. Bắt đầu từ phạm vi nhỏ

Các ví dụ giả định repository có thư mục src và dùng từ khóa minh họa calculateTotal. Chạy từ gốc repository, thay từ khóa và đường dẫn theo dự án. Các lệnh chỉ tìm kiếm, không chỉnh sửa file.

git grep -n -F -e 'calculateTotal' -- src/

-n thêm số dòng; -F tìm chuỗi nguyên văn thay vì biểu thức chính quy; -e xác định mẫu cần tìm; -- phân tách phần đường dẫn. Theo tài liệu Git grep, mặc định lệnh tìm trong nội dung working tree của các file được theo dõi.

2. Chọn đúng working tree, index hoặc commit

git grep -n -F -e 'calculateTotal' -- src/
git grep --cached -n -F -e 'calculateTotal' -- src/
git grep -n -F -e 'calculateTotal' HEAD -- src/

Ba lệnh lần lượt tìm trong file đang làm việc, nội dung index và snapshot HEAD. Chúng có thể trả kết quả khác nhau nếu bạn vừa đổi tên hàm, stage một phần rồi tiếp tục sửa. --cached không chỉ tìm các dòng mới được stage; nó tìm nội dung file trong index.

Muốn kiểm tra snapshot cũ, thay HEAD bằng mã commit đã xác minh. Đây là tìm trong một snapshot, không phải tìm toàn bộ lịch sử thay đổi của repository.

3. Khi file mới không xuất hiện trong kết quả

Kiểm tra git status --short để biết file đã được theo dõi chưa. Khi cần tìm cả file chưa được theo dõi trong phạm vi đã chọn, có thể dùng:

git grep --untracked -n -F -e 'calculateTotal' -- src/

Không vội mở rộng sang toàn bộ file bị ignore: vùng đó có thể chứa dependency, bản build hoặc cấu hình nhạy cảm. Trước hết xác nhận file cần tìm thực sự thuộc phạm vi nào. Tìm không thấy trong một tập file không chứng minh chuỗi không tồn tại ở mọi nơi.

4. Chọn output phù hợp với câu hỏi

git grep -l -F -e 'calculateTotal' HEAD -- src/

-l chỉ liệt kê tên file có kết quả, phù hợp khi bạn muốn khoanh vùng trước khi đọc mã. Nếu cần xem chi tiết, quay lại -n. Đọc đoạn mã xung quanh kết quả để phân biệt lời gọi thật, comment và dữ liệu kiểm thử.

Kết quả tìm chuỗi không thay thế phân tích ngữ nghĩa: một tên có thể được tạo động, đổi bí danh hoặc đi qua cơ chế khác. Không dùng riêng số kết quả grep để kết luận một hàm không còn được sử dụng rồi xóa nó.

5. Checklist điều tra

• Đang đứng đúng repository và dùng đúng đường dẫn.
• Đã chọn rõ working tree, index hay commit.
• Đã phân biệt chuỗi nguyên văn và regex.
• Đã kiểm tra file chưa tracked trước khi kết luận không có kết quả.
• Không chia sẻ output chứa token hoặc dữ liệu nội bộ.
• Mọi thay đổi sau tìm kiếm vẫn cần review và kiểm thử riêng.

Giá trị của Git grep không chỉ nằm ở việc tìm nhanh một chuỗi, mà ở khả năng nêu rõ bạn đã tìm trên phiên bản nào. Ghi lại phạm vi đó giúp kết quả điều tra có thể được người khác kiểm chứng.