如何在Azure DevOps YAML流水线中禁用git clean -ffdx命令？

问题背景 #

我的checkout任务被自动加上了git clean -ffdx命令，拖慢了流水线运行速度，想搞清楚这三个问题：

• 这个命令是哪来的？
• 能不能删掉？
• 有没有办法通过YAML参数配置？

我当前的YAML配置没有特殊设置，内容如下：

resources:
  - repo: self
  
pool:
  name: Mobile
  
trigger:
  branches:
    include:
      - main
steps:
- template: templates/build-server.yml

解答 #

1. 命令来源 #

git clean -ffdx是CI/CD平台（比如Azure DevOps）默认checkout步骤的内置操作。平台会自动插入默认checkout任务拉取代码，而git clean -ffdx是这个默认任务的一部分——用来彻底清理工作目录，清除上一次流水线留下的所有残留文件、构建产物或未追踪内容，确保每次构建的环境一致。

2. 能否移除 #

可以移除，但要权衡风险：

• 移除后，工作目录会保留上一次运行的残留文件，可能导致构建依赖冲突、缓存失效或者产物污染，引发不可预见的构建问题。
• 如果你的流水线使用的是每次全新的代理机器，移除的影响很小；但如果是复用代理，不建议直接移除，最好调整清理策略而非完全取消。

3. YAML参数配置方法 #

完全可以通过显式定义checkout步骤并配置参数来修改或禁用这个行为：

• 禁用默认清理：设置clean参数为false，就能跳过git clean -ffdx操作

steps:
- checkout: self
  clean: false
- template: templates/build-server.yml

• 自定义清理策略：如果需要部分清理，先关闭默认clean，再在后续步骤里自定义git clean的参数（比如只清理未追踪文件，保留已修改内容）：

steps:
- checkout: self
  clean: false
- script: git clean -fd  # 仅删除未追踪的目录和文件，保留已修改内容
  displayName: "自定义Git清理"
- template: templates/build-server.yml

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