Ignorar arquivos

Repositórios grandes têm artefatos que não devem ser lintados — build, código vendido, snapshots, código gerado. O modelo de ignores do Oxlint funciona bem em monorepos e CI.

TIP

Recomenda-se usar ignorePatterns no .oxlintrc.json ou oxlint.config.ts em vez de arquivo só de ignore, para alinhar CLI, IDE e todos os comandos que rodam Oxlint.

Ignores padrão

O Oxlint ignora automaticamente:

• diretórios .git
• arquivos minificados no nome com .min., -min. ou _min.
• arquivos que batem com .gitignore (gitignore global não entra)

Arquivos ocultos (. no nome) não são ignorados por padrão.

ignorePatterns

Faixa recomendada: definir ignores na config com ignorePatterns. Caminhos são relativos ao arquivo de config.

.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/**"],
});

Em monorepos, configs aninhadas podem ignorar saída só daquele pacote.

.eslintignore

Compatível com setups ESLint; sintaxe estilo .gitignore (comentários, negação).

Projetos novos: prefira ignorePatterns; após migrar, mova o conteúdo do .eslintignore para a config.

CLI

Ignores ad hoc:

oxlint --ignore-path path/to/ignorefile

Padrões extras:

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

Entre aspas para o shell não expandir globs.

“Designorar” (negação)

Ignore com ! permite ignorar uma pasta mas manter arquivos específicos. Para ignorar quase todo build/ exceto um arquivo, ignore o conteúdo:

.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"],
});

Assim a travessia do diretório continua possível.

Desligar todos os ignores

Inclui arquivos de ignore e --ignore-pattern:

oxlint --no-ignore