ESLint在GitHub Actions报错但本地正常，如何解决配置差异？

这问题我见过好几次了，核心原因基本都是依赖没装全或者版本不一致导致的。你本地能跑是因为你可能全局装过某些插件，或者 node_modules 里有残留的旧依赖，而 CI 里是干净环境，ESLint 找不到 rule 定义自然就报错了。

具体排查方向有三个：

第一个是 plugin:vue/vue3-recommended 这个扩展依赖了 @vue/eslint-config-typescript 和 @typescript-eslint/eslint-plugin 等配套包，但你 package.json 里可能只装了 eslint-plugin-vue，没装对应的 parser 或 plugin，导致 ESLint 加载配置时找不到 comma-dangle 的定义（虽然它其实是 ESLint 内置 rule，但某些旧版插件会覆盖或冲突）。

第二个是 node 版本问题，虽然 v18.16.0 不算老，但 GitHub Actions 的 ubuntu-latest 默认可能用的是最新 LTS，如果你在 CI 里没显式指定 node 版本，可能用了 v20+，而某些 ESLint 插件（尤其是 vue3 相关的）对高版本支持不好，或者你锁了老版本的 eslint-plugin-vue。

第三个是 CI 里没装对依赖，比如用了 npm install 但没加 --frozen-lockfile 或 --production=false，导致 devDependencies 没装全，或者你用的是 pnpm / yarn 但 CI 里写了 npm install。

解决方案很直接：

先检查 package.json 里 devDependencies 是否包含这些（版本号可以按最新来）：

eslint、@typescript-eslint/parser、@typescript-eslint/eslint-plugin、eslint-plugin-vue、eslint-config-prettier（如果用了的话）

然后确保 CI 里明确指定 node 版本，比如用 actions/setup-node@v4：

- uses: actions/setup-node@v4
with:
node-version: '18.16.0'

最后 CI 脚本里别光写 npm install，加个 npm ci（如果用了 lockfile）或者 npm install --include=dev，保证 devDependencies 装全了。

如果还不行，临时加个 --no-inline-config 或 --cache-location .eslintcache 试试，有时候缓存会搞鬼。或者直接把 comma-dangle 显式加到 rules 里规避一下，比如 'comma-dangle': ['error', 'always-multiline']，虽然治标不治本。

说白了就是 CI 环境比本地干净，你本地能跑是因为环境脏，CI 一干净就暴露问题了。这种事别硬扛，直接重装 node_modules + CI 指定版本，基本都能解决。

这问题我遇到过，八成是依赖版本不一致导致的。GitHub Actions 环境虽然用的是 ubuntu-latest，但关键是 node 版本和依赖安装方式。

你本地 ESLint 能跑通，CI 上报 comma-dangle 找不到规则，听起来像是 eslint 本身版本太低，或者插件没装上。

先确认一点：你的项目里有没有锁文件？比如 package-lock.json 或 yarn.lock？如果没有，那 CI 安装的依赖可能是最新版，容易出问题。

代码给你，改一下 workflow：

jobs:

  lint:

    runs-on: ubuntu-latest

    steps:

      - uses: actions/checkout@v3

      - uses: actions/setup-node@v3

        with:

          node-version: '18'

          cache: 'npm'

      - run: npm ci

      - run: npm run lint

重点是用 npm ci 而不是 npm install。npm ci 会严格按 lock 文件安装，避免版本漂移。

另外检查下本地是不是全局装了 eslint？如果没在 package.json 里声明 eslint 和相关插件为 devDependencies，CI 环境就找不到。

补全这些依赖：

{

  "devDependencies": {

    "eslint": "^8.0.0",

    "@typescript-eslint/eslint-plugin": "^5.0.0",

    "@typescript-eslint/parser": "^5.0.0",

    "eslint-plugin-vue": "^9.0.0"

  }

}

然后删掉 node_modules 和 lock 文件，重新 npm install，提交新的 lock 文件。

做完这三步基本就能对齐环境了。记住，本地能跑不代表 CI 能跑，必须靠 lock 文件 + npm ci 保证一致性。