如何在Azure DevOps的PR中仅对变更文件执行ESLint检查？

下面分两步解决你的问题：获取PR变更文件列表，以及针对这些文件执行ESLint检查。

一、获取PR的变更文件列表 #

方法1：用Git命令对比分支（推荐，轻量无额外依赖） #

PR本质是源分支和目标分支的代码差异，直接用Git对比两个分支就能拿到变更文件：

# 拉取目标分支最新代码
git fetch origin $(System.PullRequest.TargetBranch):$(System.PullRequest.TargetBranch)

# 对比源分支与目标分支，筛选出需要lint的文件（这里以JS/TS为例，可根据项目调整后缀）
git diff --name-only origin/$(System.PullRequest.TargetBranch) HEAD | grep -E '\.(js|jsx|ts|tsx)$' > changed_files.txt

System.PullRequest.TargetBranch是Azure DevOps预定义变量，自动指向PR的目标分支；HEAD代表当前检出的源分支代码。

方法2：用Azure DevOps CLI命令 #

如果需要更官方的API方式，可使用Azure CLI的PR文件列表命令：

# 自动登录Azure DevOps（Pipeline环境中通常已配置好权限）
az devops login --organization $(System.TeamFoundationCollectionUri) --project $(System.TeamProject)

# 获取PR所有变更文件，提取文件路径保存到文本
az repos pr files list --id $(System.PullRequest.PullRequestId) --organization $(System.TeamFoundationCollectionUri) --project $(System.TeamProject) --output json | jq -r '.[].path' > changed_files.txt

需要确保Pipeline安装了jq工具用于解析JSON输出。

二、针对变更文件执行ESLint检查 #

拿到变更文件列表后，直接传给ESLint即可：

Bash脚本实现 #

# 过滤掉已删除的文件（避免ESLint报错）
changed_files=$(grep -v '^$' changed_files.txt | while read file; do [ -f "$file" ] && echo "$file"; done)

# 执行ESLint检查，有错误则终止Pipeline
npx eslint $changed_files

集成到Azure DevOps Pipeline YAML #

把上述步骤整合到Pipeline配置中，让PR提交时自动触发检查：

trigger: none
pr:
  branches:
    include:
      - main # 替换成你的目标分支名称

jobs:
- job: ESLintPRCheck
  displayName: 'ESLint 变更文件检查'
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - task: NodeTool@0
    inputs:
      versionSpec: '18.x' # 替换成项目使用的Node.js版本
    displayName: '安装Node.js'

  - script: npm install
    displayName: '安装项目依赖'

  - script: |
      git fetch origin $(System.PullRequest.TargetBranch):$(System.PullRequest.TargetBranch)
      git diff --name-only origin/$(System.PullRequest.TargetBranch) HEAD | grep -E '\.(js|jsx|ts|tsx)$' > changed_files.txt
    displayName: '获取PR变更文件列表'

  - script: |
      changed_files=$(grep -v '^$' changed_files.txt | while read file; do [ -f "$file" ] && echo "$file"; done)
      npx eslint $changed_files
    displayName: '执行ESLint检查'
    failOnStderr: true # 检测到错误时终止Pipeline，阻止PR合并

注意事项 #

• 如果项目使用pnpm/yarn，将npm install替换为pnpm install或yarn install
• 可根据项目技术栈调整文件后缀过滤规则（比如加上.vue、.svelte等）
• 确保项目根目录存在ESLint配置文件（如.eslintrc.js、.eslintrc.json）
• Pipeline需要有代码仓库的读取权限，确保Git命令能正常执行

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