如何配置ESLint避免子目录报错导致Node.js项目Jenkins构建失败

核心逻辑是将主业务代码、新增子目录的ESLint检查拆分为两个独立执行单元：主代码检查保留「出现错误即阻断构建」的原有规则，新增子目录检查仅做问题扫描、报告生成，不触发构建失败，最终统一归档所有检查报告即可。以下是三种可直接落地的方案，按需选择：

方案1：拆分ESLint执行命令（改动最小，推荐优先使用） #

不需要调整ESLint规则配置，仅修改执行命令即可实现效果：

1. 调整package.json中的lint脚本，拆分为两个独立命令，将<new-subdir-path>替换为实际的新增子目录路径：

{
  "scripts": {
    // 原有全量检查替换为主目录检查，排除新增子目录，保留错误即失败的逻辑
    "lint:main": "eslint . --ext .js --ignore-pattern '<new-subdir-path>/**' --format html -o eslint-main-report.html",
    // 新增子目录专项检查，命令末尾加 || true 强制命令返回0退出码，不会触发Jenkins失败判定
    "lint:new-dir": "eslint <new-subdir-path> --ext .js --format html -o eslint-new-dir-report.html || true"
  }
}

2. 修改Jenkins流水线的Lint阶段，按顺序执行npm run lint:main、npm run lint:new-dir两个命令，通过Jenkins HTML Publisher插件将两份html报告都配置为构建归档制品即可。

方案2：ESLint规则等级降级（无Shell额外逻辑，配置更语义化） #

利用ESLint「仅error等级问题会返回非0退出码、warn等级问题仅提示不阻断流程」的默认特性，将新增子目录下的所有规则等级降级为warn，不需要加Shell容错逻辑：

1. 同样拆分lint命令，子目录检查时追加参数将所有规则临时调整为warn等级：

{
  "scripts": {
    "lint:main": "eslint . --ext .js --ignore-pattern '<new-subdir-path>/**' --format html -o eslint-main-report.html",
    // 所有规则按warn等级检查，不会触发非0退出码，报告中仍会完整展示所有问题
    "lint:new-dir": "eslint <new-subdir-path> --ext .js --rule '{\"*\": [\"warn\"]}' --format html -o eslint-new-dir-report.html"
  }
}

如果需要对特定规则保留error等级，也可以在子目录的检查命令中单独追加规则配置，或者在.eslintrc的overrides字段中针对该子目录做精细化规则配置。

方案3：Jenkins流水线侧容错配置（无需修改项目代码配置） #

如果不想调整项目内的脚本和ESLint配置，所有逻辑可以直接在Jenkins侧实现，以声明式流水线为例：

// 原有主代码检查阶段保持不变
stage('主代码ESLint检查') {
  steps {
    sh 'npm run lint' // 保持原有命令不变，有错误直接阻断构建
  }
}
// 新增独立阶段跑子目录检查
stage('新增子目录ESLint检查') {
  steps {
    sh 'eslint <new-subdir-path> --ext .js --format html -o eslint-new-dir-report.html'
  }
  options {
    // 该阶段执行失败时，仅标记阶段为不稳定，整个构建结果仍为成功
    catchError(buildResult: 'SUCCESS', stageResult: 'UNSTABLE')
  }
  post {
    always {
      // 无论阶段成功失败，都归档检查报告
      publishHTML(target: [
        reportDir: '.',
        reportFiles: 'eslint-new-dir-report.html',
        reportName: '新增子目录ESLint检查报告'
      ])
    }
  }
}

注意事项 #

• 不要直接将新增子目录加入.eslintignore，会跳过检查无法生成报告，不符合需求
• 所有检查报告必须配置归档，避免子目录的问题被遗漏
• 后续新增子目录代码质量达标后，记得移除容错逻辑，将其纳入主代码检查范围统一管控质量

内容的提问来源于stack exchange，提问作者Sonu