Một script đóng gói cần biết file nào đã nằm trong index và file nào mới xuất hiện trên đĩa. Quét thư mục bằng công cụ hệ thống có thể gom cả cache và file bị ignore. git ls-files cho phép hỏi Git trực tiếp về các nhóm file đó.
Bắt đầu bằng hai danh sách
Chạy từ thư mục gốc repo thử nghiệm. Lệnh đầu liệt kê các file trong index theo mặc định. Lệnh thứ hai lấy file chưa track và áp dụng quy tắc ignore chuẩn. Các lệnh chỉ đọc danh sách.
git ls-files
git ls-files --others --exclude-standard
git status --short
Tạo một file mới ngoài các mẫu ignore rồi chạy lại. File cần xuất hiện trong danh sách thứ hai. Sau git add với chính file đó, nó chuyển sang danh sách mặc định. Tạo thêm một file khớp mẫu trong .gitignore để kiểm tra –exclude-standard loại file đó khỏi nhóm untracked.
Hiểu index và working tree
File đã track vẫn có thể đang bị sửa. Danh sách mặc định không tự nói rằng nội dung trên đĩa giống commit. Dùng git diff hoặc git status để xem trạng thái thay đổi. File đã xóa khỏi working tree có thể vẫn còn trong index cho tới khi stage thao tác xóa.
Quy tắc ignore chủ yếu liên quan file chưa track. Thêm một đường dẫn đã track vào .gitignore không tự loại nó khỏi index. Nếu mục tiêu là dừng theo dõi file cấu hình local, xem quy trình thay đổi index riêng và kiểm tra ảnh hưởng lên các thành viên khác trước khi commit.
Dùng trong script
Tên file có thể chứa khoảng trắng hoặc xuống dòng. Khi đưa danh sách cho chương trình khác, dùng -z và parser hỗ trợ dấu NUL thay vì vòng lặp tách chuỗi theo khoảng trắng. Chẳng hạn, git ls-files -z tạo luồng tên file phân cách bằng NUL. Hãy thử script bằng một file có khoảng trắng để phát hiện cách tách sai.
Nếu chạy từ thư mục con, kiểm tra phạm vi đầu ra và pathspec trước khi dùng danh sách để đóng gói toàn repo. Ghi rõ thư mục làm việc của script để kết quả có thể tái hiện giữa local và CI.
Kiểm tra trước khi dùng làm nguồn đóng gói
So sánh danh sách với git status, rồi xem những file build cần nhưng chưa được track. Dữ liệu sinh ra có thể cần bước build riêng và không xuất hiện trong danh sách index. git ls-files giải thích trạng thái quản lý file; nó không tự xác định mọi đầu vào cần thiết cho một bản phát hành.
Để kiểm tra cách script xử lý tên file, tạo một tên có dấu cách trong repo tạm rồi stage nó. Đối chiếu đúng một đường dẫn đầy đủ ở đầu ra đã phân tách, thay vì hai phần của tên bị hiểu thành hai file.


