在GitHub Actions子目录运行ESLint时，如何指定子目录配置文件？

数据老陈

2026-7-2

解决GitHub Actions中ESLint优先加载父目录配置的问题

核心逻辑

ESLint默认会向上遍历目录寻找配置文件，即便指定了子目录配置，也可能因父目录配置存在引发冲突。要彻底让ESLint仅使用子目录配置，需明确阻止它向上查找。

具体解决方法

1. 给子目录配置添加`root: true`

在子目录的.eslintrc.js（或对应格式的配置文件）中加入root: true，告知ESLint当前目录就是配置根目录，停止向上查找父目录配置：

module.exports = {
  root: true,
  // 子目录的其他ESLint配置项
  extends: [...],
  plugins: [...],
  rules: {...}
};

2. 调整GitHub Actions工作流执行逻辑

确保工作流正确切换到子目录，执行lint时明确指定子目录配置，避免父目录配置干扰：

jobs:
  lint-child-app:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 配置Node.js环境
        uses: actions/setup-node@v4
        with:
          node-version: 20
      - name: 安装子目录依赖
        working-directory: ./child
        run: npm install
      - name: 用子目录配置运行ESLint
        working-directory: ./child
        run: npx eslint . --config ./.eslintrc.js

直接用npx eslint执行，规避npm run lint可能的参数传递问题，同时明确指定当前目录的配置文件。

3. 临时屏蔽父目录ESLint配置（可选）

若上述方法无效，可在执行lint前临时重命名父目录的.eslintrc文件，执行完成后恢复：

- name: 临时重命名父目录ESLint配置
        run: mv .eslintrc.js .eslintrc.js.temp
      - name: 在子目录运行ESLint
        working-directory: ./child
        run: npm run lint
      - name: 恢复父目录ESLint配置
        run: mv .eslintrc.js.temp .eslintrc.js

此方法较为直接，适合特殊场景下的应急处理。