Azure DevOps：未跟踪文件阻碍新版本文件推送问题

问题本质 #

首次运行后工作目录残留未跟踪的myJson.json，二次切换分支时触发冲突报错；加-f强制切换后，要么文件未被正确识别为变更，要么内容无变化，导致推送无实质内容。

可稳定重复运行的流水线执行步骤 #

以下步骤适配主流DevOps流水线工具（GitLab CI/CD、GitHub Actions等），核心是确保每次运行时工作区干净、分支状态正确：

1. 初始化干净工作环境
   流水线启动后先执行：

   git clean -fd && git reset --hard HEAD
   

   彻底清空工作区的未跟踪文件、临时文件，重置索引到当前分支的最新干净状态，从根源避免残留文件干扰分支切换。

2. 拉取并切换到目标归档分支
   先确保本地有目标分支的最新引用，再切换分支：

   git fetch origin DIN_grafana_json_archives:DIN_grafana_json_archives
   git checkout DIN_grafana_json_archives
   

   即使目标分支是空分支，fetch命令也会创建本地分支引用，避免切换时出现“分支不存在”的问题。

3. 生成文件并提交推送

   • 运行Python脚本生成文件：

     python your_script_name.py
     

   • 强制添加文件到Git索引（确保覆盖已跟踪的旧版本）：

     git add -f myJson.json
     

   • 提交变更，用带时间戳的提交信息（避免空提交报错）：

     git commit -m "Archive myJson.json $(date +'%Y-%m-%d %H:%M:%S')" || echo "No content changes to commit"
     

   • 推送到远程归档分支：

     git push origin DIN_grafana_json_archives
     

4. 优化小技巧

   • 如果脚本生成的JSON内容可能和上次完全一致，可以在提交前对比文件哈希，只有哈希变化时才执行提交推送，减少无效操作：

     OLD_HASH=$(git log -1 --pretty=format:"%h" -- myJson.json 2>/dev/null || echo "")
     NEW_HASH=$(sha256sum myJson.json | awk '{print $1}')
     if [ "$OLD_HASH" != "$NEW_HASH" ]; then
       git add -f myJson.json
       git commit -m "Archive myJson.json $(date +'%Y-%m-%d %H:%M:%S')"
       git push origin DIN_grafana_json_archives
     else
       echo "JSON content unchanged, skip commit"
     fi
     

   • 确保流水线使用的Git账号拥有仓库的推送权限，避免推送时权限报错。

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