eslint-config-standard: Cấu Hình ESLint Cho Standard Style

eslint-config-standard Là Gì?

eslint-config-standard là một gói npm biến bộ quy tắc của JavaScript Standard Style thành một đối tượng cấu hình ESLint dạng flat duy nhất. Bạn cài nó cùng với ESLint, đặt nó vào mảng bên trong eslint.config.js, và nó áp dụng quy tắc của Standard mà không cần viết từng quy tắc bằng tay. README mô tả nó là phần cấu hình đứng sau JavaScript Standard Style, nhắm tới người đã quen tự lắp ráp pipeline ESLint của riêng mình.

Các Quy Tắc Phong Cách Cốt Lõi

• ✓README của chính gói này không liệt kê từng quy tắc; nó dẫn bạn sang standardjs.com để xem đầy đủ bộ quy tắc, các plugin cho editor, và phần FAQ.
• ✓Nó xuất bộ quy tắc của Standard dưới dạng một đối tượng cấu hình ESLint flat duy nhất, đúng định dạng mảng mà eslint.config.js yêu cầu, thay vì file .eslintrc kiểu cũ.
• ✓README đóng khung đây là lựa chọn tích hợp thủ công: ai chỉ muốn có sẵn một công cụ lint để chạy thì được hướng sang gói standard.
• ✓Ví dụ eslint.config.js trong README cho thấy cấu hình này nằm trong một mảng cạnh một đối tượng thường, nên phần ghi đè nằm ngay bên cạnh, không cần cú pháp extends.
• ✓Đi kèm một huy hiệu kiểu shields.io cho phong cách code 'standard' mà dự án có thể gắn vào README của mình khi đã đạt chuẩn.
• ✓Được gắn nhãn trên GitHub với các chủ đề như eslint, javascript, linter, style-guide, và static-code-analysis, khớp với vai trò hẹp của nó: chỉ có quy tắc, không kèm bundler hay formatter.

Các Bước Cài Đặt

README chỉ đưa ra một lệnh: npm install --save-dev eslint eslint-config-standard, kéo theo cả ESLint lẫn cấu hình chia sẻ này. Không có chương trình thực thi riêng ở đây. Cài xong bạn chưa có ngay một công cụ lint chạy được, mà chỉ có phần định nghĩa quy tắc để tích hợp ở bước sau. Nếu không muốn tự tích hợp, README chỉ sang gói standard, vốn cài luôn một lệnh chạy được.

Cấu Hình ESLint Với Standard Style

Mở eslint.config.js, require gói này bằng const standard = require('eslint-config-standard'), rồi export một mảng với standard đứng đầu tiên. Thêm một đối tượng thường ngay sau đó cho bất kỳ thay đổi quy tắc nào bạn muốn, đúng theo mẫu trong README. Vì ESLint xử lý các mảng cấu hình flat theo thứ tự, những gì bạn đặt trong đối tượng thứ hai sẽ thắng các giá trị mặc định của Standard, nên không cần trường extends riêng để học. README chỉ mô tả cách thiết lập flat config này; các dự án còn dùng .eslintrc kiểu cũ không được nói tới ở đây.

Các Style Guide JavaScript Khác

Câu Hỏi Thường Gặp

Vấn đề mà nó giải quyết

Một nhóm đã tự chạy ESLint qua file cấu hình riêng không thể chỉ gắn thêm CLI standard vào, vì công cụ đó gộp cả phần định nghĩa quy tắc lẫn phần chạy quy tắc vào một chương trình duy nhất thay vì để lộ quy tắc ra riêng. eslint-config-standard sinh ra để lấp đúng khoảng trống đó: nó trao bộ quy tắc của Standard dưới dạng một đối tượng cấu hình ESLint thuần túy, để có thể nằm trong một eslint.config.js đã có sẵn, cạnh bất cứ thứ gì hệ thống lint của dự án đang làm.

Trường hợp sử dụng tốt nhất

• •Các dự án đã gọi ESLint trực tiếp qua eslint.config.js và muốn quy tắc của Standard là một mục trong mảng thay vì tự chọn từng quy tắc bằng tay.
• •Các nhóm chồng thêm phần ghi đè hoặc quy tắc từ plugin khác lên trên một phong cách nền, vì ví dụ trong README thêm một đối tượng thường ngay sau standard.
• •Các pipeline CI gọi eslint trực tiếp, nơi một cấu hình thuần túy dễ viết script hơn là bọc thêm một CLI thứ hai.
• •Bất kỳ ai đang xây preset riêng và muốn lấy quy tắc của Standard làm điểm khởi đầu, thay vì dùng nguyên cả gói standard.

Ai nên dùng — và ai nên bỏ qua

Hãy thử eslint-config-standard nếu bạn đã chạy ESLint qua eslint.config.js và muốn quy tắc của Standard là một mục trong mảng mà bạn có thể ghi đè, đúng như cách README đóng khung gói này. Bỏ qua nếu bạn không muốn đụng vào file cấu hình chút nào: hãy cài standard thay thế, vì README nói đó là gói dành cho người chỉ muốn lint code mà không cần thiết lập gì.

Repo liên quan