Azure Pipelines中已确认Git工作目录干净，但执行npm version patch仍报'Git working directory not clean'错误的原因排查

我来帮你拆解下这个问题的可能原因和对应的解决办法——明明git status和git reset --hard都显示工作目录干净，npm version patch却还是报错提示工作目录不干净，确实挺让人困惑的。结合你的流水线日志和场景，我整理了几个排查方向：

1. 被忽略的文件曾被Git追踪过 #

虽然你已经把SonarCloud遗留的目录加入了.gitignore，但如果这些目录曾经被Git提交追踪过（比如之前不小心把.sonar目录推送到了仓库），仅仅添加.gitignore不会让Git停止追踪它们。这类文件会留在Git的索引中，常规git status可能不会显示，但npm version调用的git status --porcelain会检测到这些“已追踪但被忽略”的文件，从而判定工作目录不干净。

解决方法：
在流水线中添加步骤，清理Git索引中被忽略的文件：

# 替换成你实际要清理的SonarCloud目录
git rm -r --cached .sonar/
git add .gitignore
git commit -m "Clean up tracked ignored files"

2. Azure Pipelines浅克隆导致的Git状态异常 #

Azure Pipelines默认使用浅克隆（fetchDepth: 1），只拉取最新的commit，这种情况下Git的某些状态可能出现异常——比如npm version需要访问完整的Git历史或标签信息，浅克隆可能导致索引和工作区不同步。

解决方法：
修改流水线的Checkout步骤，关闭浅克隆拉取完整仓库历史：

steps:
- checkout: self
  fetchDepth: 0  # 拉取完整仓库历史，避免浅克隆带来的状态异常

3. 隐藏的Git变更（如文件权限、符号链接） #

有时候文件权限的变更（比如执行权限被修改）、符号链接的变动，在默认git status输出中可能不显眼，但git status --porcelain会明确显示这些变更，而npm version正是依赖这个命令判断工作目录是否干净。

解决方法：
在npm version步骤前添加步骤，查看详细的Git状态，定位隐藏变更：

# 查看精简格式的Git状态，所有变更都会显示
git status --porcelain
# 查看工作区与HEAD的差异
git diff
# 查看索引与HEAD的差异
git diff --cached

如果是文件权限问题，可以关闭Git的文件权限检测：

git config core.filemode false

4. Git用户配置不完整 #

Azure Pipelines Agent的Git用户配置可能不完整，导致npm version在调用Git提交时出现隐性异常，间接触发工作目录不干净的报错。

解决方法：
在npm version步骤前显式设置Git用户信息：

git config user.name "Azure Pipelines Agent"
git config user.email "azuredevops@microsoft.com"

临时应急方案（不推荐长期使用） #

如果需要紧急修复流水线，可以给npm version加上--force参数，强制跳过工作目录检查：

- task: Npm@1
  displayName: '标记仓库并设置发布版本'
  inputs:
    command: 'custom'
    customCommand: 'version patch --force'

内容的提问来源于stack exchange，提问作者usr-local-ΕΨΗΕΛΩΝ