Azure DevOps流水线中commitlint--from分支引用异常问题求助

通用前提修复 #

• 启用完整Git克隆：Azure DevOps流水线默认是浅克隆（仅拉取最新1次提交），导致无法获取完整提交历史和远程分支引用，需在流水线中设置fetchDepth: 0。
• 添加commitlint配置文件：必须创建配置文件加载@commitlint/config-conventional规则，否则commitlint无校验标准，所有提交都会显示通过。

修正后的流水线配置（推荐Ubuntu镜像） #

以下配置同时解决两个问题，确保commitlint能正确校验主分支到当前提交的所有提交信息：

trigger:
- main

pool:
  vmImage: ubuntu-latest

# 启用完整克隆，获取所有提交历史和分支
resources:
  repositories:
  - repository: self
    type: git
    fetchDepth: 0

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

stages:
- stage: LintCommitMessages
  jobs:
  - job: ValidateCommitMessages
    displayName: 校验提交信息
    steps:
    - script: |
        # 安装commitlint依赖
        npm install @commitlint/config-conventional @commitlint/cli
        # 创建commitlint配置文件，启用conventional规则
        echo '{"extends": ["@commitlint/config-conventional"]}' > .commitlintrc.json
      displayName: 安装并配置commitlint
    - script: |
        # 校验从origin/main到当前HEAD的所有提交
        npx commitlint --from origin/main --to HEAD --verbose
      displayName: 执行commitlint校验

原问题具体原因 #

第一种配置失败原因 #

• 流水线默认浅克隆，refs/remotes/origin/main引用不存在，Git无法解析提交范围origin/main..HEAD。
• 未添加commitlint配置文件，即使克隆正常，也无法启用校验规则。

第二种配置无校验效果原因 #

• 缺少commitlint配置文件，@commitlint/config-conventional规则未被加载，commitlint无校验标准，所有提交都判定为通过。
• 浅克隆导致提交历史不完整，无法获取主分支到当前提交的完整记录。

额外注意事项 #

• 若主分支为master，将origin/main替换为origin/master即可。
• 若使用Windows镜像，需将创建配置文件的命令改为PowerShell语法：'{"extends": ["@commitlint/config-conventional"]}' | Out-File -FilePath .commitlintrc.json -Encoding utf8。
• 针对PR触发的流水线，可通过System.PullRequest.TargetBranch变量动态获取目标分支，适配多分支场景：

  target_branch="origin/$(echo $(System.PullRequest.TargetBranch) | cut -d'/' -f3-)"
  npx commitlint --from $target_branch --to HEAD --verbose
  

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