File và thư mục nào nên đưa vào .gitignore của Unity?

ASCENO / UNITY STUDY NOTES · 67

File và thư mục nào nên đưa vào .gitignore của Unity?

Which Unity Files and Folders Belong in .gitignore?

Bài học bắt đầu bằng một ảnh chụp trực tiếp từ Unity để người đọc biết thao tác thực hành. Chín hình sau là minh họa không chữ; phần giải thích song ngữ bên dưới mới là nội dung cần đọc. Chủ đề chính là unity gitignore. Ảnh số 1 là bằng chứng thực hành; ảnh số 2–10 chỉ dùng hình khối, biểu tượng và quan hệ trực quan để có thể giữ nguyên khi chuyển sang ngôn ngữ khác.

Mục tiêu học tập

• Giải thích được khái niệm bằng mô hình hoặc luồng dữ liệu.
• Biết chính xác màn hình Unity nào cần mở.
• Dự đoán kết quả trước khi bấm Play và tìm được bằng chứng.
• Tự dựng lại thí nghiệm nhỏ và xử lý lỗi có phương pháp.

1. Thực hành trực tiếp trong Unity

Mở đúng Scene test, chọn object liên quan và thực hiện thao tác được mô tả trong bài. Hình này là ảnh Unity native để người đọc nhận ra nơi bắt đầu; các bước và ý nghĩa nằm trong phần chữ ngay bên dưới.

2. Minh họa hệ thống

.gitignore giúp Git bỏ qua cache, file tạm và output có thể tái tạo, trong khi vẫn giữ source quan trọng như Assets, Packages và ProjectSettings. Ignore sai có thể làm mất cấu hình hoặc làm repository phình to. Hình minh họa bên dưới không chứa câu chữ để không bị khóa vào một ngôn ngữ; hãy đọc phần giải thích này cùng các bước cụ thể.

• unity gitignore | khái niệm đang học | đọc phần focus và ví dụ thực hành | không suy luận chỉ từ màu sắc của object
• Input/setting | dữ liệu hoặc cấu hình đầu vào | ghi giá trị trước khi đổi | không đổi nhiều thứ cùng lúc
• Result/evidence | thứ phải quan sát trong Scene, Game, Inspector hoặc Console | chụp đúng panel | không coi ảnh đẹp là bằng chứng

3. Minh họa nguyên nhân → kết quả

Hãy đọc hướng mũi tên, vị trí tương đối và thay đổi của biểu tượng như một quan hệ nhân quả. Không cần dựa vào chữ nằm trong ảnh; phần dưới đây giải thích từng bước bằng văn bản.

1. Chọn câu hỏi cần trả lời
2. Tạo Scene test nhỏ
3. Đổi một giá trị hoặc reference
4. Bấm Play / chạy thao tác
5. Đọc đúng panel
6. So sánh với dự đoán

4. Minh họa trình tự hoạt động

Mở Unity và xác định đúng cửa sổ tạo ra kết quả của bài; chỉ chụp sau khi tên object, field hoặc output cần học đã nhìn thấy rõ.

5. Minh họa cấu trúc object

Đọc tên object trong Hierarchy trước. Nếu tên không nói lên vai trò, hãy đổi tên trong Scene test; screenshot chỉ có giá trị khi người đọc biết mình đang nhìn object nào.

6. Minh họa cấu hình

Chọn object đại diện cho unity gitignore trong Hierarchy. Đọc Transform trước, sau đó tìm Component/field liên quan. Ghi lại giá trị hiện tại rồi mới thay đổi; Theo dõi Assets, Packages và ProjectSettings

7. Minh họa quan sát kết quả

Console không phải ảnh trang trí: dùng nó để xác nhận Nếu file đã tracked, thêm .gitignore không tự xoá nó khỏi Git; cần xử lý index có chủ đích. Nếu bài không sinh log, kiểm tra object active, script compile và Console filter trước khi sửa thêm code.

8. Minh họa code → state

Đừng chép code rời khỏi Scene. Trước mỗi dòng, chỉ ra object/reference đầu vào; sau mỗi dòng, chỉ ra state hoặc output nào phải thay đổi.

# Unity generated folders
/[Ll]ibrary/
/[Tt]emp/
/[Oo]bj/
/[Ll]ogs/
/[Uu]ser[Ss]ettings/

# Build output
/[Bb]uild/
/[Bb]uilds/

9. Minh họa thí nghiệm

Bài phân nhóm thư mục Unity thường gặp, giải thích Library khác Assets ra sao và đưa ra quy trình kiểm tra bằng git status trước commit đầu tiên.

1. Theo dõi Assets, Packages và ProjectSettings.
2. Bỏ qua Library, Temp, Obj, Logs, UserSettings và build output.
3. Nếu file đã tracked, thêm .gitignore không tự xoá nó khỏi Git; cần xử lý index có chủ đích.
4. Chạy lại sau khi hoàn nguyên để kiểm tra kết quả có lặp lại không.
5. Ghi lại giá trị đầu vào, thao tác, kết quả và lý do thay đổi.

10. Minh họa lỗi → cách sửa

• Chọn nhầm object hoặc asset nên sửa đúng chỗ nhưng kết quả không đổi.
• Đổi nhiều field cùng lúc nên không truy được nguyên nhân.
• Chỉ nhìn Scene mà bỏ qua Inspector/Console.
• Không kiểm chứng riêng phần unity gitignore.

Góc nhìn ASCENO: Một hình ảnh tốt phải giúp người đọc trả lời được một câu hỏi cụ thể. Nếu ảnh không cho biết chọn gì, nhìn ở đâu, đổi gì hoặc kết quả nằm ở đâu, ảnh đó chưa đủ điều kiện đưa vào tài liệu.