Tham khảo cấu hình
Tất cả các trường được hỗ trợ trong signalint.config.json, bao gồm giá trị mặc định và hành vi xác thực.
Signalint đọc file signalint.config.json từ gốc dự án được kiểm tra. File này là tùy chọn; các trường bị bỏ qua sẽ nhận giá trị mặc định bên dưới. Các key không xác định và kiểu dữ liệu không chính xác sẽ báo lỗi cấu hình.
{
"engines": {
"oxlint": true,
"tsc": true,
"biome": false
},
"ignore": ["node_modules/**", "dist/**", ".signalint/**"],
"timeoutsMs": {
"oxlint": 30000,
"tsc": 120000,
"biome": 30000
}
}Các trường cấp cao nhất
| Trường | Kiểu | Mặc định | Ý nghĩa |
|---|---|---|---|
engines | object | Xem bên dưới | Bật hoặc tắt từng engine tích hợp. |
ignore | string[] | node_modules/**, dist/**, .signalint/** | Các đường dẫn tương đối bị loại bỏ khỏi danh sách file yêu cầu và kết quả chẩn đoán cuối cùng. |
timeoutsMs | object | Xem bên dưới | Thời hạn giới hạn tiến trình con (tính bằng miligiây, số nguyên dương). |
engines
| Trường | Kiểu | Mặc định | Hành vi |
|---|---|---|---|
oxlint | boolean | true | Chạy chẩn đoán Oxlint theo từng file. |
tsc | boolean | true | Chạy chẩn đoán TypeScript toàn bộ chương trình từ tsconfig gốc. |
biome | boolean | false | Chạy chẩn đoán Biome theo từng file. |
Các key engine bị bỏ qua vẫn giữ giá trị mặc định riêng; chúng không bị ép về false.
ignore
Mỗi mục phải là một mẫu glob đường dẫn tương đối không rỗng. Signalint hỗ trợ *, ** và ?, đồng thời chuẩn hóa ký tự phân cách đường dẫn Windows. Vì tsc là kiểm tra toàn bộ chương trình, nó vẫn thấy toàn bộ chương trình đã cấu hình khi được gọi; các chẩn đoán khớp với mẫu ignore sẽ được loại bỏ khỏi phản hồi.
Các chẩn đoán có đường dẫn chứa phân đoạn node_modules sẽ luôn bị loại trừ, bất kể cài đặt này.
timeoutsMs
| Trường | Kiểu | Mặc định |
|---|---|---|
oxlint | số nguyên dương | 30.000 ms |
tsc | số nguyên dương | 120.000 ms |
biome | số nguyên dương | 30.000 ms |
Khi hết thời gian timeout, Signalint sẽ chấm dứt cây tiến trình của engine đó. Trong phản hồi chẩn đoán schema 1.1, engine đó sẽ nhận { "status": "error", "message": "…" } dưới mục engines, trong khi chẩn đoán từ các engine đã hoàn thành khác vẫn được giữ nguyên.
Cấu hình gốc của engine
Giữ các quy tắc lint và compiler trong file cấu hình gốc của chúng. Cache hash v1 nhận diện các file gốc .oxlintrc, .oxlintrc.json, oxlint.json, tsconfig.json, biome.json và biome.jsonc. Thay đổi một trong các file này sẽ làm mất hiệu lực cache của engine tương ứng.
Các nguồn hợp lệ khác—bao gồm .oxlintrc.jsonc, cấu hình mở rộng (extended config) và cấu hình package lồng nhau—không thuộc về cache hashing của v1. Hãy xóa .signalint/ sau khi thay đổi một trong những file đó.