Debug.Log và Console: cách debug game Unity cho người mới

ASCENO / UNITY STUDY NOTES · 59

Debug.Log và Console: cách debug game Unity cho người mới

Debug.Log and the Console: Debugging a Unity Game

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à debug unity. Ả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

Debug.Log biến trạng thái bên trong thành thông tin nhìn thấy được trong Console. Biết log có ngữ cảnh, lọc message và đọc stack trace là kỹ năng sống còn khi làm game. 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ể.

• debug unity | 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. Reproduce
2. Log
3. Console
4. Stack trace
5. Inspect
6. Fix

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 debug unity 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; Viết log gồm tên object, state và giá trị quan trọng thay vì chỉ ‘đã chạy’

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 Tắt hoặc giảm log spam trước khi build bản chia sẻ. 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.

using UnityEngine;

public class DebugExample : MonoBehaviour
{
    [SerializeField] private int health = 10;

    public void TakeDamage(int amount)
    {
        health -= amount;
        Debug.Log($"{name} took {amount} damage; health={health}", this);
        if (health < 0) Debug.LogWarning("Health dropped below zero.", this);
    }
}

9. Minh họa thí nghiệm

Bài tạo log cho input, state change và collision, sau đó phân biệt Log, Warning và Error. Mục tiêu là biến quá trình debug thành một cuộc điều tra có bằng chứng.

1. Viết log gồm tên object, state và giá trị quan trọng thay vì chỉ ‘đã chạy’.
2. Dùng Debug.LogError cho điều kiện không thể tiếp tục và truyền context object.
3. Tắt hoặc giảm log spam trước khi build bản chia sẻ.
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 debug unity.

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.