무시 파일

큰 저장소에는 빌드 산출, 벤더 코드, 스냅샷, 생성물처럼 린트하면 안 되는 파일이 있습니다. Oxlint는 모노레포와 CI에서도 예측 가능한 무시 모델을 제공합니다.

TIP

별도 무시 파일보다 Oxlint 설정(.oxlintrc.json 또는 oxlint.config.ts)의 "ignorePatterns" 사용을 강력히 권장합니다. IDE 등 Oxlint를 실행하는 모든 도구에서 동일한 무시가 적용되고, 설정이 한 파일에 모입니다.

기본 무시

Oxlint가 자동으로 무시하는 항목:

• .git 디렉터리
• 파일명에 .min., -min., _min.가 들어 있는 축소(minified) 파일
• .gitignore에 맞는 파일(전역 gitignore는 반영하지 않음)

숨김 파일은 자동으로 무시하지 않습니다.

ignorePatterns

설정 파일의 ignorePatterns에 무시를 두는 방식을 권장합니다. 무시가 해당 설정과 함께 있고 중첩 설정과도 잘 맞습니다.

패턴은 설정 파일 위치 기준으로 해석됩니다.

.oxlintrc.json

{
  "$schema": "./node_modules/oxlint/configuration_schema.json",
  "ignorePatterns": ["dist/**", "coverage/**", "vendor/**", "test/snapshots/**"]
}

oxlint.config.ts

import { defineConfig } from "oxlint";

export default defineConfig({
  ignorePatterns: ["dist/**", "coverage/**", "vendor/**", "test/snapshots/**"],
});

모노레포에서는 중첩 설정으로 패키지별 산출만 무시할 수 있습니다.

.eslintignore

기존 ESLint와의 호환을 위해 .eslintignore도 지원합니다. 마이그레이션 중에는 그대로 둬도 됩니다. 구문은 .gitignore와 호환되며 주석·부정 패턴도 됩니다.

새 프로젝트는 설정 파일의 "ignorePatterns"를 쓰고, 마이그레이션 후 가능한 한 빨리 옮기는 것을 권장합니다.

명령줄에서 무시

CI 일회성 변경이나 로컬 디버깅에 CLI 플래그가 편합니다.

사용자 정의 무시 파일:

oxlint --ignore-path path/to/ignorefile

무시 패턴 추가:

oxlint --ignore-pattern 'dist/**' --ignore-pattern 'coverage/**'

패턴은 셸 글로브 확장을 피하도록 따옴표로 감싸세요.

무시 해제(negation)

무시 파일은 부정 패턴을 지원해, 디렉터리는 무시하되 특정 파일만 남길 수 있습니다.

build/ 아래는 대부분 무시하고 한 파일만 남기려면 디렉터리 자체가 아니라 내용을 무시하세요.

.oxlintrc.json

{
  "$schema": "./node_modules/oxlint/configuration_schema.json",
  "ignorePatterns": ["build/**/*", "!build/keep.js"]
}

oxlint.config.ts

import { defineConfig } from "oxlint";

export default defineConfig({
  ignorePatterns: ["build/**/*", "!build/keep.js"],
});

디렉터리 순회는 가능하면 유지하면서 거의 전부를 무시할 수 있습니다.

무시 끄기

무시 파일과 CLI 무시 옵션을 포함해 모든 무시 동작을 끄려면 --no-ignore를 사용합니다.

oxlint --no-ignore