다중 파일 분석

다중 파일 분석을 사용하면 각 파일을 개별적으로 분석하는 대신, 모듈 종속성 그래프와 같은 프로젝트 전체 정보를 규칙에서 활용할 수 있습니다.

성능 및 아키텍처

ESLint는 각 파일 단위로 규칙을 평가하며 내장된 프로젝트 그래프를 제공하지 않습니다. eslint-plugin-import와 같은 플러그인은 ESLint 커널 외부에서 모듈 해석과 모듈 그래프를 다시 구성해야 합니다. 일부 프로젝트에서는 원래 import/no-cycle 규칙이 수십 초 또는 더 큰 저장소에서는 1분 이상 소요된다고 보고했습니다.

Oxlint는 핵심 엔진에서 다중 파일 분석을 구현합니다. 파일을 동시에 린팅하고 모듈 그래프를 생성하며, 규칙 간에 파싱 및 해석을 공유하므로 일반적인 import/no-cycle 검사를 몇 초 안에 완료할 수 있습니다.

import 플러그인 활성화

다중 파일 분석을 사용하려면 import 플러그인을 활성화하고 적어도 하나의 import/* 규칙을 구성해야 합니다. 예시는 다음 섹션의 설정 파일을 참조하세요.

import/no-cycle으로 주기 탐지

import/no-cycle을 활성화하여 순환 종속성을 탐지하세요.

가져오기 주기의 문제점:

• 종속성 방향을 숨깁니다
• 리팩터링을 어렵게 만듭니다
• 평가 순서로 인해 가져온 값이 undefined가 될 수 있습니다

.oxlintrc.json

{
  "$schema": "./node_modules/oxlint/configuration_schema.json",
  "plugins": ["import"],
  "rules": {
    "import/no-cycle": ["error", { "maxDepth": 3 }]
  }
}

TypeScript 경로 별칭

import/* 규칙을 실행할 때, Oxlint는 자동으로 tsconfig.json을 탐지하여 compilerOptions.paths와 같은 TypeScript 경로 별칭을 해결합니다.