無視対象のファイル

大きなリポジトリには、チェックすべきでないファイル（ビルド出力、ベンダリングされたコード、スナップショット、または生成されたアーティファクトなど）が含まれます。Oxlint はモノレポや CI 環境でもうまく機能する予測可能な無視モデルを提供しています。

TIP

ファイルを無視するには、ignorePatterns を使用することを強く推奨します。これは oxlint.config.ts や .oxlintrc.json の設定ファイル内で定義されるものです。これにより、すべての開発者が、Oxlint を実行するすべてのツールやコマンド（特に IDE やエディタの統合機能）で同一の無視ルールを持つようになります。また、設定を1つのファイルに集中管理できるためです。

デフォルトの無視対象

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" に移行することを強く推奨します。場合によっては移行時に同時に移行することも可能です。

コマンドラインからの無視指定

CLI フラグは、CI での一時的な変更やローカルでのデバッグに便利です。

カスタムの無視ファイルを使用する場合：

oxlint --ignore-path path/to/ignorefile

追加の無視パターンを指定する場合：

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

シェルのグロブ展開を避けるために、パターンは引用符で囲んでください。

ファイルの無視解除

無視ファイルは否定パターン（ネガティブパターン）をサポートしており、ディレクトリ全体を無視しつつ特定のファイルだけは保持することが可能になります。

build/ の下にあるすべてのファイルを無視したいが、1つのファイルだけは無視しない場合、ディレクトリ自体ではなく、その内容を無視するようにします：

.oxlintrc.json

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

これにより、ほぼすべてのファイルが無視されつつ、トラバースは可能な状態を維持できます。

無視の無効化

すべての無視動作（無視ファイルや CLI の無視オプションを含む）を無効にするには、--no-ignore オプションを使用します：

oxlint --no-ignore