Cấu hìnhv0.2.0 / schema 1.1

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ườngKiểuMặc địnhÝ nghĩa
enginesobjectXem bên dướiBật hoặc tắt từng engine tích hợp.
ignorestring[]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.
timeoutsMsobjectXem bên dướiThờ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ườngKiểuMặc địnhHành vi
oxlintbooleantrueChạy chẩn đoán Oxlint theo từng file.
tscbooleantrueChạy chẩn đoán TypeScript toàn bộ chương trình từ tsconfig gốc.
biomebooleanfalseChạ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ợ *, **?, đồ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ườngKiểuMặc định
oxlintsố nguyên dương30.000 ms
tscsố nguyên dương120.000 ms
biomesố nguyên dương30.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.jsonbiome.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 đó.