Bộ định dạng JavaScript

Tùy chọn kiểu

Vì sao định dạng lại quan trọng

Định dạng không chỉ để đẹp mắt, mà là để giảm tải nhận thức. Một cơ sở mã được định dạng nhất quán giúp người rà soát tập trung vào thay đổi logic, thay vì đi tìm một dấu ngoặc đặt sai chỗ.

• Tranh cãi vặt vãnh kết thúc ngay khi một dự án áp dụng bộ định dạng. git diff cho thấy thay đổi thật sự, không phải các tranh luận về thụt lề.
• Hook trước khi commit (với công cụ như Husky + lint-staged) tự động định dạng các tệp đã staging trước khi commit.
• Tích hợp với trình soạn thảo (VS Code, WebStorm) áp dụng cùng quy tắc khi lưu.

Những gì định dạng không làm

• Nó không lint. Các quy tắc về kiểu (no-unused-vars, eqeqeq) thuộc phạm vi của ESLint. Bộ định dạng chỉ sắp xếp lại khoảng trắng và dấu câu, nó không từ chối mã vì vấn đề logic.
• Nó không sửa lỗi cú pháp. Nếu đầu vào là JS không hợp lệ, bộ định dạng sẽ báo lỗi. Hãy dùng nó như một cách kiểm tra rằng mã của bạn ít nhất phân tích được.
• Nó không áp đặt quy ước đặt tên. camelCase so với snake_case là quy tắc của lint, không phải của bộ định dạng.

Những lỗi thường gặp

• Cãi nhau với bộ định dạng. Nếu bạn cứ định dạng lại bằng tay sau khi nó đã chạy, cả hai đều đang lãng phí thời gian. Hãy cấu hình các tùy chọn, hoặc chấp nhận lựa chọn của dự án.
• Chạy định dạng trên tệp được sinh ra. Đầu ra của bundler, mã đã transpile, .min.js, không cái nào được lợi. Hãy định dạng mã nguồn, đừng định dạng sản phẩm đầu ra.
• Định dạng mà không phân tích cú pháp. Kiểu “in đẹp” dựa trên regex sẽ làm hỏng template literal, regex literal và JSX. Luôn dùng bộ định dạng dựa trên AST (như công cụ này).