#从 vite-plugin-eslint 迁移

vite-plugin-eslint2 从 gxmari007/vite-plugin-eslint 分叉出来，一直在维护，加了新功能、支持更多版本、修了问题。下面是把项目迁过来的步骤。

#安装

npm uninstall vite-plugin-eslint
npm install vite-plugin-eslint2 -D

#换导入

- import eslint from 'vite-plugin-eslint'
+ import eslint from 'vite-plugin-eslint2'

#选项变化

#默认值

cache 现在默认开着。include 限定在 src/，源文件在别处就自己改。

#去掉的选项

#新增选项

#类型变化

formatter 不再接受函数，只能传格式化器的名称或路径。

#cacheLocation

vite-plugin-eslint 默认是 Vite 的 cacheDir + '/.eslintcache'。vite-plugin-eslint2 默认是项目根目录的 .eslintcache，也就是 ESLint 自己的默认值。

#行为变化

#apply 钩子

vite-plugin-eslint 什么模式下都跑。vite-plugin-eslint2 用 apply 决定什么时候生效：

要在构建时校验，设 build: true：

eslint({ build: true })

#虚拟模块

vite-plugin-eslint2 总是忽略虚拟模块：virtual:、\0 前缀，以及不带 / 的模块 ID。你不用再手动排除。

#版本兼容

#迁移之后

// vite.config.ts
import { defineConfig } from "vite";
import eslint from "vite-plugin-eslint2";

export default defineConfig({
  plugins: [eslint()],
});

要在构建时校验（旧插件的默认行为）：

export default defineConfig({
  plugins: [eslint({ build: true })],
});

日常开发可以从这个配置开始：

export default defineConfig({
  plugins: [eslint({
    fix: true,
    lintInWorker: true,
    lintOnStart: true,
  })],
});