GitHub gitignore templates: Bộ Mẫu .gitignore Chính Thức

Bộ Mẫu gitignore Của GitHub Là Gì?

GitHub gitignore templates là bộ sưu tập file .gitignore được lưu trong repo github/gitignore, chính là danh sách mà GitHub.com dùng để lấp đầy bộ chọn mẫu khi bạn tạo repo hoặc file mới. Các mẫu được chia thành ba tầng: một bộ mẫu gốc đã chọn lọc cho ngôn ngữ và công nghệ phổ biến, thư mục Global cho trình soạn thảo, công cụ và hệ điều hành, và thư mục community cho các mẫu chuyên biệt hơn hoặc theo phiên bản.

Hiểu Cấu Trúc Bộ Mẫu

• ✓Thư mục gốc chứa các mẫu đang dùng phổ biến cho ngôn ngữ và công nghệ thông dụng, được README mô tả là một tập luật có ý nghĩa giúp người dùng bắt đầu.
• ✓Thư mục Global bao phủ trình soạn thảo, công cụ và hệ điều hành áp dụng được cho nhiều dự án khác nhau, chứ không riêng một ngôn ngữ.
• ✓Thư mục community chứa các mẫu chuyên biệt cho ngôn ngữ, công cụ và dự án chưa lọt vào bộ mẫu gốc đã chọn lọc.
• ✓Quy tắc phiên bản khá chặt: thư mục gốc luôn giữ mẫu hiện tại, không đánh số phiên bản, còn các bản cũ theo phiên bản cụ thể chuyển sang community/ với số phiên bản gắn ngay trong tên file.
• ✓Có một tiêu chuẩn chất lượng để quyết định mẫu nào được vào gốc — mẫu cần một tập luật chọn lọc cho một ngôn ngữ, framework, công cụ hay môi trường cụ thể, chứ không phải danh sách lan man các file mà một phiên bản phần mềm nào đó cài vào.
• ✓Các mẫu chuyên biệt trong community/ được kỳ vọng ghi chú mẫu liên quan trong comment ở đầu file, giống cách ví dụ community/DotNet/InforCRM.gitignore trong README gợi ý dùng kèm VisualStudio.gitignore.

Áp Dụng Các Mẫu gitignore

Cách trực tiếp nhất là con đường GitHub đã dựng sẵn: khi tạo repo mới hoặc thêm file mới trên GitHub.com, một bộ chọn .gitignore hiện ra và đọc dữ liệu từ bộ sưu tập này, nên chọn ngôn ngữ ở đó là bạn có ngay mẫu gốc hiện tại mà không cần thêm bước nào. Ngoài luồng đó, hãy copy mẫu gốc phù hợp vào dự án của bạn dưới tên .gitignore, rồi chèn thêm các mục Global/ cho trình soạn thảo hoặc hệ điều hành của mình lên trên. README khuyên nên gộp các mẫu Global vào cấu hình git toàn cục trên máy hoặc vào file của dự án nếu bạn muốn các luật đó tồn tại lâu dài, và tìm đến community/ khi bạn bắt đầu dùng một framework hay công cụ chuyên biệt hơn. Về cơ chế thật sự của các mẫu .gitignore, README dẫn tới chương Ignoring Files của cuốn Pro Git, bài viết Ignoring Files trên trang trợ giúp của GitHub, và trang manual gitignore(5), thay vì tự diễn giải lại.

Cách Khác Để Loại Trừ File

Câu Hỏi Thường Gặp

Vấn đề nó giải quyết

GitHub cần một nguồn luật loại trừ file được duy trì thường xuyên để đưa vào tùy chọn .gitignore trong màn hình tạo repo và tạo file của chính họ, thay vì tự chế một danh sách tùy tiện hoặc để mỗi repo mới bắt đầu từ con số không. Trước khi có danh sách như thế này, nhà phát triển thường copy lại một ví dụ cũ từ dự án trước, đoán mò xem công cụ build của một ngôn ngữ hay rải file gì ra, hoặc bỏ qua hẳn .gitignore rồi lỡ commit nhầm thư mục dependency hay file cấu hình IDE. Repo này cho bộ chọn đó — và bất kỳ ai duyệt trực tiếp — một câu trả lời đã chọn lọc theo từng ngôn ngữ.

Trường hợp sử dụng tốt nhất

• •Chọn ngay một .gitignore khởi đầu từ bộ chọn mẫu khi tạo repo mới trên GitHub.com.
• •Lấy một mẫu theo ngôn ngữ hoặc framework từ thư mục gốc rồi đưa vào một dự án đã có sẵn.
• •Gộp các mục Global/ phù hợp cho trình soạn thảo hoặc hệ điều hành của bạn vào cấu hình git toàn cục trên máy, để rác cá nhân không lọt vào từng dự án mà cũng không làm rối file dự án.
• •Lục trong community/ để tìm mẫu cho một framework hay công cụ chưa lọt vào bộ mẫu gốc.
• •Lấy một mẫu cũ theo phiên bản cụ thể trong community/ cho phần mềm legacy vẫn còn dùng.

Cách cài đặt / dùng thử

Không có gì để cài đặt cả. Đây là một tập hợp file văn bản thuần, không phải package hay CLI. Lý do tồn tại mà README nêu ra là GitHub.com lấy trực tiếp từ danh sách này để lấp đầy bộ chọn .gitignore mà bạn thấy khi tạo repo hoặc file mới, nên việc thử nó đơn giản chỉ là chọn một ngôn ngữ ở đó. Muốn lấy mẫu ngoài luồng đó, hãy mở file tương ứng trong repo github/gitignore trên GitHub.com rồi copy nội dung vào file .gitignore của dự án bạn. README không nêu bất kỳ package manager hay API nào để lấy mẫu theo cách lập trình.

Ai nên dùng — và ai nên bỏ qua

Hãy dùng GitHub gitignore templates nếu bạn đang tạo repo cho một ngôn ngữ phổ biến và muốn một danh sách loại trừ đã chọn lọc thay vì tự gõ luật theo trí nhớ, hoặc nếu bạn duy trì cấu hình git toàn cục trên máy và muốn có sẵn các mục cho trình soạn thảo, hệ điều hành. Bỏ qua việc duyệt trực tiếp repo này nếu stack của bạn đủ hiếm để có khả năng nằm sâu trong community/ hoặc không hề có mặt — hãy kiểm tra ở đó trước, hoặc chuẩn bị tự viết luật riêng.

Repo liên quan