Chẩn đoán LSP — Kiểm tra Mã Khi Bạn Gõ

Hãy nghĩ về một công cụ kiểm tra chính tả cho bài viết của bạn, nhưng dành cho mã nguồn — đó chính là LSP Diagnostics.

LSP, Rốt Cuộc Là Gì?

LSP là viết tắt của Language Server Protocol (Giao thức Máy chủ Ngôn ngữ). Đây là một trợ lý hoạt động ngầm mà trình soạn thảo mã của bạn liên lạc cùng. Khi bạn gõ, trình soạn thảo sẽ gửi mã của bạn đến máy chủ ngôn ngữ, nơi kiểm tra lỗi và gửi lại các gợi ý. Bạn sẽ thấy kết quả dưới dạng các gạch chân màu đỏ, cảnh báo màu vàng hoặc các biểu tượng bóng đèn nhỏ.

Trong Hermes Agent, chúng tôi sử dụng LSP để cung cấp cho bạn phản hồi tức thì trong lúc bạn viết — không cần chạy một lệnh “kiểm tra” riêng biệt. Nó giống như có một lập trình viên cấp cao kiên nhẫn đang nhìn qua vai bạn, chỉ ra các lỗi chính tả và sai sót logic trước cả khi bạn lưu tệp.

Tại Sao Người Mới Bắt Đầu Nên Quan Tâm?

Bạn không cần biết LSP hoạt động bên trong như thế nào. Nhưng bạn cần biết rằng:

Nó phát hiện các lỗi đơn giản (thiếu dấu ngoặc, sai tên biến) ngay lập tức.
Nó dạy bạn trong lúc làm — di chuột qua một gạch chân để xem vấn đề và cách sửa.
Nó tiết kiệm thời gian — bạn sửa lỗi khi chúng còn mới, thay vì sau một phiên gỡ lỗi dài dằng dặc.

Cách Sử Dụng LSP Diagnostics trong Hermes Agent

Hermes Agent được tích hợp sẵn hỗ trợ LSP. Đây là cách bắt đầu:

1. Mở Dự Án Của Bạn

Đảm bảo bạn đang ở trong thư mục chứa mã nguồn. Trong terminal:

cd my-project

2. Khởi Động Tích Hợp Trình Soạn Thảo của Hermes Agent

Chạy lệnh này (hoặc sử dụng phím tắt trong trình soạn thảo của bạn):

hermes lsp start

Bây giờ, mở bất kỳ tệp .py, .js, .ts hoặc .go nào. Bạn sẽ thấy các chẩn đoán xuất hiện tự động.

3. Đọc Bảng Chẩn Đoán

Trong hầu hết các trình soạn thảo, nhấn:

Ctrl+Shift+M   (Windows/Linux)
Cmd+Shift+M    (Mac)

Thao tác này sẽ mở bảng “Problems” (Vấn đề). Nó liệt kê mọi lỗi, kèm theo tên tệp, số dòng và mô tả ngắn gọn.

4. Áp Dụng Sửa Chữa Nhanh

Nhấp vào một dòng gạch chân. Một cửa sổ nhỏ sẽ hiện ra. Chọn “Quick Fix” (Sửa nhanh) hoặc nhấn:

Ctrl+.   (Windows/Linux)
Cmd+.    (Mac)

Hermes Agent sẽ đề xuất một cách sửa — thường chỉ cần một lần nhấn phím để chấp nhận.

Các Biểu Tượng Có Ý Nghĩa Gì?

Gạch chân đỏ = lỗi. Có gì đó chắc chắn sai (ví dụ: hàm không được định nghĩa).
Gạch chân vàng = cảnh báo. Không nghiêm trọng, nhưng có khả năng là lỗi (ví dụ: biến không được sử dụng).
Bóng đèn màu xanh = gợi ý. Cải thiện tùy chọn (ví dụ: đơn giản hóa mã này).

Một Ví Dụ Thực Tế

Giả sử bạn gõ đoạn mã Python này:

def greet(name):
    print("Hello, " + nam)

Chú ý đến nam — một lỗi chính tả. LSP sẽ gạch chân nó màu đỏ. Di chuột qua nó, bạn sẽ thấy:

Name "nam" is not defined. Did you mean "name"?

Nhấp vào sửa nhanh, và nó sẽ tự động đổi thành name. Bạn vừa tránh được một vụ sập chương trình.

Các Lỗi Thường Gặp (Và Cách Tránh)

Đừng bỏ qua cảnh báo — chúng thường chỉ ra các lỗi tiềm ẩn trong tương lai.
Kiểm tra bảng thường xuyên — không chỉ dòng hiện tại.
Nếu bạn thấy “No LSP server found” — hãy đảm bảo bạn đã chạy hermes lsp start và loại tệp của bạn được hỗ trợ.

Tóm Tắt và Mẹo Thực Tế

LSP Diagnostics cung cấp cho bạn phản hồi theo thời gian thực, làm cho việc viết mã trở nên giống một cuộc trò chuyện hơn là một trò chơi đoán mò. Bạn viết, công cụ nhắc nhở, bạn sửa — đơn giản vậy thôi.

Mẹo thực tế: Trước khi chạy mã, hãy luôn nhìn lướt qua bảng Problems. Một cái nhìn nhanh có thể giúp bạn tiết kiệm mười phút gỡ lỗi “Tại sao cái này lại hỏng?”. Hãy tạo thói quen này — bản thân tương lai của bạn sẽ cảm ơn bạn.

Bây giờ hãy đi viết mã nào, và để những gạch chân dẫn đường cho bạn.