Чем flat config в ESLint отличается от старого формата конфига?

Flat config — это переработанный подход к конфигурации ESLint, введённый как основной в ESLint 9. Он заменяет старую систему .eslintrc, которая использовала каскадное наследование и множество неявных правил поиска конфигов.

Ключевые отличия

• Один файл вместо иерархии. В flat config используется файл eslint.config.js (или .mjs/.cjs), экспортирующий массив объектов конфигурации. Старый формат допускал множество .eslintrc файлов в разных директориях с автоматическим слиянием.
• Явное наследование. Вместо extends с путями к пакетам, в flat config вы просто импортируете конфиг как JS-модуль и добавляете его в массив.
• ESM и типизация. Flat config нативно работает с ESM и легко типизируется через TypeScript.
• Глобальные игноры. В старом формате .eslintignore был отдельным файлом, теперь игноры задаются полем ignores прямо в конфиге.

Пример flat config

// eslint.config.js
import js from '@eslint/js';
import tseslint from 'typescript-eslint';

export default [
  js.configs.recommended,
  ...tseslint.configs.recommended,
  {
    files: ['**/*.ts'],
    rules: {
      'no-unused-vars': 'warn',
    },
  },
  {
    ignores: ['dist/**', 'node_modules/**'],
  },
];

Как это применяется

Flat config удобен в монорепозиториях и проектах с TypeScript, где важно явно контролировать порядок применения правил. Массив обрабатывается сверху вниз, и последующие объекты переопределяют предыдущие — это делает поведение предсказуемым.

Итог: flat config стоит применять в новых проектах и при миграции на ESLint 9+, так как он проще, явнее и лучше сочетается с современным тулингом.