如何配置Jenkins，避免Git拉取时覆盖项目中的指定TXT文件？

方法一：将对比文件移出Git追踪并备份恢复（推荐） #

这是最符合Git工作流的方案，核心是让Git不再管理这两个对比文件，同时在构建前后备份恢复它们：

• 1. 在本地项目根目录创建/修改.gitignore文件，添加这两个文件名：

  file1.txt
  file2.txt
  

  提交并推送这个.gitignore到GitHub仓库，这样后续Git拉取时不会同步这两个文件，自然不会覆盖。
• 2. 在Jenkins构建流程中添加前置步骤（在Git拉取之前）：
     用Shell命令备份文件到临时目录：

  # 备份对比文件到Jenkins临时目录
  [ -f file1.txt ] && cp file1.txt "${JENKINS_HOME}/tmp/file1_backup_${BUILD_NUMBER}.txt"
  [ -f file2.txt ] && cp file2.txt "${JENKINS_HOME}/tmp/file2_backup_${BUILD_NUMBER}.txt"
  

• 3. 执行默认的Git拉取操作（Jenkins Git插件的拉取步骤）。
• 4. 添加后置恢复步骤（在Git拉取之后）：
     将备份的文件复制回项目根目录：

  # 恢复对比文件
  [ -f "${JENKINS_HOME}/tmp/file1_backup_${BUILD_NUMBER}.txt" ] && cp "${JENKINS_HOME}/tmp/file1_backup_${BUILD_NUMBER}.txt" file1.txt
  [ -f "${JENKINS_HOME}/tmp/file2_backup_${BUILD_NUMBER}.txt" ] && cp "${JENKINS_HOME}/tmp/file2_backup_${BUILD_NUMBER}.txt" file2.txt
  # 可选：清理临时备份
  rm -f "${JENKINS_HOME}/tmp/file1_backup_${BUILD_NUMBER}.txt" "${JENKINS_HOME}/tmp/file2_backup_${BUILD_NUMBER}.txt"
  

方法二：用Git Stash临时保存对比文件 #

如果不想修改.gitignore，可以在拉取前暂存对比文件，拉取后恢复：

• 在Jenkins中替换默认的Git拉取步骤为自定义Shell命令：

  # 暂存当前的对比文件
  git stash push -m "temp backup compare files" file1.txt file2.txt
  # 拉取最新代码
  git pull origin main # 替换为你的目标分支名
  # 恢复暂存的文件
  git stash pop
  

注意：如果远程仓库中这两个文件有更新，git stash pop会触发冲突，需要手动处理，不适合无人值守的自动化构建场景。

方法三：将对比文件移到Git工作区之外 #

彻底隔离对比文件和Git仓库，避免任何覆盖风险：

• 修改你的构建对比逻辑，将生成的对比文件保存到Jenkins工作区之外的固定目录，比如/var/jenkins/compare_files/。
• 在Jenkins构建时，直接从这个固定目录读取上一次的对比文件，生成新文件后覆盖或重命名（比如file1_prev.txt和file1_current.txt）。
• 确保Jenkins进程对该目录有读写权限。

内容的提问来源于stack exchange，提问作者Péter Sánta