Jenkins checkout步骤未覆盖修改后的data.csv文件问题

问题原因 #

这是SCM工具（比如Git）的默认安全机制导致的：当本地文件存在未提交的修改，且远程仓库中对应文件没有更新时，SCM会跳过覆盖操作，防止本地修改丢失。Jenkins的checkout scm步骤只是调用底层SCM命令，所以会遵循这个规则。而远程仓库文件更新时，SCM会判断本地修改和远程更新存在同步需求，因此会正常拉取覆盖。

解决方案 #

1. 强制全局清理后拉取 #

如果每次构建都需要从仓库获取干净的代码，不需要保留本地修改，可以在checkout步骤中添加清理参数：

• Pipeline脚本扩展配置写法：

checkout([
    $class: 'GitSCM',
    branches: [[name: '*/main']],
    userRemoteConfigs: [[url: '你的仓库地址']],
    extensions: [[$class: 'CleanCheckout']]
])

• 简化写法（适用于默认SCM配置）：

checkout scm, clean: true

该配置会执行git clean -fd和git reset --hard HEAD，强制将本地工作区恢复为与远程仓库完全一致的状态。

2. 单独重置目标文件 #

如果只需要恢复data.csv而不影响其他文件，可以在checkout步骤前添加手动重置命令：

// Git环境
sh 'git checkout HEAD -- data.csv'

// SVN环境
sh 'svn revert data.csv'

3. 使用独立构建目录（推荐） #

让每次构建使用全新的工作目录，彻底避免残留文件干扰：

ws("/var/jenkins/workspace/${JOB_NAME}_${BUILD_NUMBER}") {
    checkout scm
    // 执行后续构建逻辑
}

也可以在Jenkins任务的"高级项目选项"中勾选"使用自定义工作区"，配置动态生成的目录路径。

4. 检查SCM插件配置 #

确认Jenkins中对应的SCM插件（如Git Plugin）没有启用"保留本地修改"类的额外配置，这类配置会导致checkout时跳过修改过的文件。

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