Игнорирование файлов

В крупных репозиториях много файлов, которые не нужно линтить: сборка, vendored-код, снапшоты, генерируемые артефакты. У Oxlint предсказуемая модель игноров, удобная в монорепо и CI.

TIP

Настоятельно рекомендуется задавать игноры через "ignorePatterns" в конфиге Oxlint (.oxlintrc.json или oxlint.config.ts), а не отдельным ignore-файлом. Так у всех одинаковые игноры во всех командах и интеграциях редактора, конфигурация остаётся в одном месте.

Игноры по умолчанию

Oxlint автоматически игнорирует:

• каталоги .git
• минифицированные файлы с .min., -min. или _min. в имени
• файлы по .gitignore (глобальный gitignore не учитывается)

Скрытые файлы автоматически не игнорируются.

ignorePatterns

Рекомендуемый способ — ignorePatterns в конфиге. Игноры рядом с остальными настройками и естественно работают с вложенными конфигами.

Шаблоны разрешаются относительно файла конфигурации.

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

В монорепо вложенные конфиги могут игнорировать вывод конкретного пакета, не затрагивая остальное.

.eslintignore

Поддерживается для совместимости с ESLint. Синтаксис как у .gitignore: комментарии и отрицание.

В новых проектах предпочтительнее "ignorePatterns" в конфиге; после миграции лучше перенести содержимое .eslintignore в конфиг.

Игноры из командной строки

Удобно для разовых сценариев в CI или при отладке.

Свой файл игноров:

oxlint --ignore-path path/to/ignorefile

Дополнительные шаблоны:

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

Экранируйте шаблоны кавычками, чтобы shell не раскрывал glob.

Снятие игнора

Отрицательные шаблоны: игнорировать каталог, но оставить отдельные файлы.

Чтобы игнорировать почти всё в build/, но не build/keep.js, игнорируйте содержимое, а не сам каталог:

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

Обход дерева сохраняется, лишнее по-прежнему не линтится.

Отключить игнорирование

Полностью отключить учёт игноров (файлы и флаги CLI):

oxlint --no-ignore