Chú thích mã và docstring: Làm thế nào để chỉ dịch chú thích mà không ảnh hưởng đến mã?
“Khi đưa trực tiếp tệp mã nguồn vào trình dịch, thường cả tên biến và các từ khóa logic (if/for) cũng bị dịch, dẫn đến mã không còn thực thi được.”
Phân tích nguyên nhân gốc rễ
Nhận diện cấp độ AST (cây cú pháp trừu tượng)
AI của Shangyi không chỉ dừng lại ở việc đối chiếu bằng regex mà còn thực hiện phân tích cú pháp nhẹ. Đối với Python, AI có thể nhận diện chính xác các Docstrings được bao bằng `'''...'''`; Đối với Java/JS, hệ thống có thể nhận diện các khối `/**...*/`.
Giữ lại chỉ dẫn
Bên trong các khối chú thích, với các chỉ dẫn cụ thể như `@param`, `@return`, `@author`, hệ thống sẽ giữ lại phần đầu chỉ dẫn và chỉ dịch phần mô tả phía sau, đảm bảo định dạng đúng khi tạo tài liệu API (ví dụ Javadoc, Sphinx).
Tổng kết giải pháp cuối cùng
Giúp các dự án mã nguồn mở nhanh chóng tạo tài liệu đa ngôn ngữ, giảm rào cản đóng góp cho các lập trình viên trên toàn thế giới.