무시 파일

대규모 리포지터리에는 빌드 출력물, 번들된 코드, 스냅샷 또는 생성된 아티팩트와 같은 검사를 하지 않아야 하는 파일이 포함되어 있습니다. Oxlint는 모노레포 및 CI 환경에서도 잘 작동하는 예측 가능한 무시 모델을 제공합니다.

TIP

파일을 무시하기 위해 별도의 무시 파일보다는 ignorePatterns를 사용하는 것이 강력히 권장됩니다. 이는 .oxlintrc.json 또는 oxlint.config.ts 파일 내에서 설정하는 방식입니다. 이렇게 하면 모든 개발자가 다양한 도구 및 명령어(특히 IDE/에디터 통합 기능)에서 동일한 무시 규칙을 사용하게 되며, 구성이 중앙 집중화되어 관리가 쉬워집니다.

기본 무시 항목

Oxlint는 자동으로 다음 항목을 무시합니다:

• .git 디렉터리
• 파일 이름에 .min., -min. 또는 _min.이 포함된 압축 파일
• .gitignore에 일치하는 파일 (전역적인 gitignore 파일은 적용되지 않음)

숨겨진 파일은 자동으로 무시되지 않습니다.

ignorePatterns

권장되는 접근 방식은 구성 파일 내에서 ignorePatterns를 사용하여 무시 항목을 정의하는 것입니다. 이 방법은 관련 구성과 가까운 위치에 무시 항목을 유지할 수 있으며, 중첩된 구성과 자연스럽게 호환됩니다.

패턴은 구성 파일 기준으로 해석됩니다.

.oxlintrc.json

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

모노레포 환경에서는 중첩된 구성이 특정 패키지의 출력물을 무시하면서 전체 리포지터리의 다른 부분에 영향을 주지 않도록 할 수 있습니다.

.eslintignore

Oxlint는 기존 ESLint 설정과의 호환성을 위해 .eslintignore도 지원합니다. 마이그레이션 중에도 기존의 .eslintignore 파일을 그대로 유지할 수 있습니다. 문법은 .gitignore와 호환되며, 주석 및 부정 패턴도 지원합니다.

새로운 프로젝트는 구성 파일 내에서 "ignorePatterns"를 우선적으로 사용하고, 마이그레이션 후 가능한 한 빠르게 "ignorePatterns"로 전환하는 것이 좋습니다. 마이그레이션 과정 중에도 전환을 고려하세요.

명령줄에서 무시 지정

명령줄 플래그는 CI 환경이나 로컬 디버깅 시 일회성 변경에 유용합니다.

사용자 정의 무시 파일 사용:

oxlint --ignore-path path/to/ignorefile

추가 무시 패턴 추가:

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

쉘 글로브 확장 방지를 위해 패턴을 따옴표로 감싸세요.

무시 취소

무시 파일은 부정 패턴을 지원하며, 디렉터리는 무시하지만 특정 파일은 유지할 수 있도록 합니다.

build/ 아래의 모든 항목을 무시하되, 하나의 파일만 유지하려면 디렉터리 자체가 아니라 내용을 무시해야 합니다:

.oxlintrc.json

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

이 방식은 거의 모든 항목을 무시하면서도 탐색이 가능하도록 유지합니다.

무시 비활성화

모든 무시 기능(무시 파일 및 명령줄 무시 옵션 포함)을 비활성화하려면 --no-ignore를 사용하세요:

oxlint --no-ignore