Cách đọc lỗi và debug cho người mới học code

Mới học code mà thấy màn hình hiện một khối chữ đỏ là dễ hoảng — nhiều người tưởng mình “không có khiếu”. Sự thật ngược lại: gặp lỗi là phần bình thường và thường xuyên nhất của lập trình, kể cả với người làm lâu năm. Khác biệt giữa người mới và người giỏi không phải là “không gây lỗi”, mà là biết đọc lỗi và sửa nhanh. Bài này dạy đúng kỹ năng đó: đọc thông báo lỗi, nhận ra ba loại lỗi, và một quy trình debug làm theo được ngay.

Đọc thông báo lỗi: bắt đầu từ dòng cuối

Khi gặp lỗi, hãy đọc dòng cuối cùng trước — đó thường là loại lỗi và mô tả ngắn gọn nhất, ví dụ NameError: name 'x' is not defined. Đừng để cả khối chữ đỏ làm bạn choáng; 90% thông tin bạn cần nằm ở dòng cuối + vị trí lỗi.

Cách bóc tách một thông báo lỗi:

• Dòng cuối = loại lỗi (NameError, TypeError, SyntaxError…) + mô tả nó là gì.
• Phần ở giữa (stack trace) = đường đi dẫn tới lỗi; tìm dòng có tên file của bạn và số dòng — đó là nơi cần xem.
• Bỏ qua các dòng trỏ vào file thư viện hệ thống (không phải code bạn viết) trong lần đọc đầu.

Ví dụ một thông báo lỗi Python thật:

Traceback (most recent call last):
  File "tinhtien.py", line 8, in <module>     ← file VÀ dòng của bạn: xem dòng 8
    tong = gia * so_luong
TypeError: can't multiply sequence by non-int of type 'str'   ← ĐỌC DÒNG NÀY TRƯỚC

Dòng cuối nói loại lỗi (TypeError) và lý do (đang nhân với một chuỗi thay vì số) — gợi ý ngay rằng so_luong đang là chữ, cần đổi sang số. Dòng File "...", line 8 chỉ đúng chỗ cần sửa. Chỉ cần đọc đúng “loại lỗi gì, ở dòng nào” là bạn đã đi được nửa chặng đường.

Ba loại lỗi bạn sẽ gặp

Hiểu lỗi thuộc loại nào giúp bạn biết hướng sửa. Gần như mọi lỗi rơi vào một trong ba nhóm:

• Lỗi cú pháp (syntax error): viết sai “ngữ pháp” của ngôn ngữ — thiếu dấu :, lệch ngoặc, sai thụt lề. Chương trình không chạy được cho tới khi sửa. Đây là lỗi dễ sửa nhất vì trình soạn thảo thường gạch đỏ ngay.
• Lỗi khi chạy (runtime error): code đúng cú pháp nhưng gãy lúc chạy — chia cho 0, gọi biến chưa tạo, mở file không tồn tại. Thông báo lỗi chỉ rõ dòng gây ra.
• Lỗi logic: chương trình chạy ngon nhưng cho kết quả sai — đây là loại khó nhất vì không có chữ đỏ nào báo. Ví dụ: tính điểm trung bình mà viết (a + b) / 2 + c thay vì (a + b + c) / 3 — máy vẫn ra một con số, chỉ là số sai. Bạn phát hiện bằng cách so kết quả thực tế với kết quả mong đợi (thử với số liệu bạn biết trước đáp án).

Quy trình debug từng bước

Khi gặp bug, làm theo thứ tự sau thay vì sửa lung tung:

1. Đọc thông báo lỗi (loại + vị trí) như mục trên.
2. Mở đúng dòng được chỉ, xem kỹ dòng đó và vài dòng trước nó.
3. Tái hiện lỗi: xác định chính xác thao tác nào làm lỗi xuất hiện — lỗi tái hiện được là lỗi sửa được.
4. In giá trị ra để soi: dùng print() (Python) hoặc console.log() (JavaScript) đặt trước chỗ nghi ngờ để xem biến đang mang giá trị gì. Đây là kỹ thuật đơn giản mà hiệu quả nhất cho người mới.
5. Sửa một thứ rồi chạy lại — đừng đổi nhiều chỗ cùng lúc, sẽ không biết cái nào hiệu quả.

In giá trị biến: công cụ đầu tay

Với người mới, cách tìm bug nhanh nhất là in giá trị biến ra màn hình để xem chương trình chạy tới đâu và dữ liệu có đúng không. Đặt print(bien) tại các điểm khác nhau, chạy, và quan sát chỗ nào giá trị “lệch” so với bạn nghĩ — bug nằm ngay quanh đó.

Đây không phải cách “kém chuyên nghiệp”: ngay cả lập trình viên kỳ cựu vẫn dùng print để soi nhanh. Khi bài toán lớn hơn, hãy học thêm debugger (đặt breakpoint để dừng chương trình và xem từng bước) — công cụ này có sẵn trong VS Code; xem hướng dẫn cài và dùng VS Code cho người mới.

Khi bí: hỏi Google và AI đúng cách

Nếu đọc lỗi mà vẫn không hiểu, tìm kiếm là kỹ năng hợp lệ và quan trọng. Bí quyết là hỏi đúng:

• Copy đúng dòng thông báo lỗi (loại lỗi + mô tả), không chụp cả màn hình mơ hồ.
• Khi hỏi AI, dán kèm đoạn code liên quan và nói rõ “tôi mong đợi X, nhưng thực tế xảy ra Y”.
• Đọc nhiều kết quả (StackOverflow…) thay vì copy đại giải pháp đầu tiên — hiểu vì sao mới tránh lỗi lần sau.

Mẹo cũ mà hiệu nghiệm: nếu bí quá, rời máy 10 phút. Rất nhiều bug “tự lòi ra” khi đầu óc thư giãn.

Bước tiếp theo cụ thể

Lần tới gặp chữ đỏ, đừng đóng vội — đọc to dòng cuối cùng và tìm số dòng, đó là phản xạ quan trọng nhất cần luyện. Sau đó thử đặt một print() để soi biến trước khi sửa. Càng gặp nhiều lỗi và xử lý bình tĩnh, bạn càng tiến bộ nhanh — đây chính là lúc kỹ năng lập trình thật sự lớn lên. Muốn quản lý code và quay lui khi sửa hỏng, học thêm Git cơ bản cho người mới.