Skip to content

ESLint v9 Flat Config:設定結構與遷移檢查

更新於 適用版本: ESLint 9.x (historical migration)

修訂說明:保留原始歸檔日期及連結,本文於 2026-10-24 重寫。ESLint v9 正式版發佈於 2024-04-05,以下是後續整理的遷移說明,不代表 2023 年該版本已正式發佈。ESLint v9 已結束官方維護,新專案應參考官方版本支援表選擇仍受維護的版本。

Flat Config 的重點是用 JavaScript 模組匯出設定陣列。符合相同檔案的多個設定物件依序組合,後面的同名規則可以覆蓋前面的值;files 決定物件套用至哪些檔案。

一個設定陣列 ​

以下針對歷史上的 ESLint 9 及 @eslint/js 9,說明遷移結構。這是教學設定,不包含正式環境部署或效能驗證的聲明。

javascript
// eslint.config.mjs — historical ESLint 9 example
import js from '@eslint/js'

export default [
  { ignores: ['dist/**', 'coverage/**'] },
  js.configs.recommended,
  {
    files: ['**/*.js'],
    languageOptions: { ecmaVersion: 2022, sourceType: 'module' },
    rules: { 'no-unused-vars': 'warn' },
  },
]

js.configs.recommended 提供建議規則,最後一個物件為 JavaScript 檔案調整特定規則。只有 ignores 的物件表達全域忽略規則。瀏覽器或 Node.js 全域變數、TypeScript 解析器、Vue 單檔元件解析器及框架外掛需要另外設定,這個範例不適用於所有專案。

遷移時檢查甚麼 ​

  1. 固定 ESLint 及外掛版本,確認支援 Flat Config 及對應 ESLint 主版本。
  2. 將舊設定的 env、parserOptions、globals 逐項對應至新格式,不只更改檔名。
  3. 把忽略路徑移入設定。Flat Config 不會自動保留舊 .eslintignore 的行為,須重新檢查路徑匹配。
  4. 對目標檔案執行 npx eslint --print-config src/example.js,確認最終規則及語言選項。
  5. 分別檢查應通過、應報錯和應忽略的檔案,再執行完整 lint。通過 lint 不代表業務功能已驗證。

版本與更新 ​

本篇保留 v9 的遷移背景;目前專案請以實際版本的官方文件為準,不把設定範例標記成正式環境驗證案例。

參考資料 ​

MIT Licensed