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:
| Mecanismo | Escopo |
|---|---|
Caminhos CLI com prefixo ! | Global |
.prettierignore / --ignore-path | Global |
ignorePatterns na config | Relativo à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:
{
"ignorePatterns": ["dist/**", "*.min.js"]
}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ê
.gitignoreglobal 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.