Skip to content

Ignorar arquivos

O Oxfmt oferece várias formas de excluir arquivos.

Algumas valem para todo o run; outras ficam escopadas ao arquivo de config a que pertencem:

MecanismoEscopo
Caminhos CLI com prefixo !Global
.prettierignore / --ignore-pathGlobal
ignorePatterns na configRelativo àquela config

Com config aninhada, ignorePatterns só vale para arquivos resolvidos por aquela config. Mecanismos globais aplicam sempre.

ignorePatterns

Forma recomendada — no arquivo de config Oxfmt:

json
{
  "ignorePatterns": ["dist/**", "*.min.js"]
}
ts
import { defineConfig } from "oxfmt";

export default defineConfig({
  ignorePatterns: ["dist/**", "*.min.js"],
});
  • Sintaxe no estilo .gitignore
  • Caminhos relativos ao diretório do arquivo de config
  • Independentes do Git

Arquivos que casam não serão formatados, mesmo quando passados explicitamente.

.gitignore

Oxfmt honra .gitignore na árvore do diretório atual.

  • Não lê .gitignore global nem de diretórios pai
  • Não precisa haver .git

O Git pode ignorar e o arquivo ainda pode ser formatado se for passado diretamente.

Diretórios VCS e node_modules

Ignorados por padrão: .git, .svn, .jj, node_modules

Use --with-node-modules para incluir node_modules.

Arquivos de lock

package-lock.json, pnpm-lock.yaml, etc. são sempre ignorados.

.prettierignore

Por compatibilidade com Prettier. Sintaxe no estilo .gitignore.

Não será formatado ainda quando listado explicitamente.

Em projetos novos prefira ignorePatterns.