如何在Jenkins Groovy流水线全代码库中查找并替换指定文本

以下实现默认你已经完成GitLab仓库克隆，流水线执行时处于仓库根目录对应工作区。

方案1：Shell命令实现（优先推荐） #

性能远高于纯Groovy遍历，尤其适合大仓库场景，代码简洁易维护，兼容绝大多数Linux架构的Jenkins节点。

stage('检索并替换目标字符串') {
    steps {
        // 如果你克隆的仓库不在当前工作区根目录，可加上dir块指定路径
        // dir("你的仓库本地克隆目录") {
            sh """
                # 检索所有含find_me的文件，排除.git目录避免损坏仓库元数据
                grep -r "find_me" --exclude-dir=.git ./ | cut -d: -f1 | sort | uniq > target_files.txt
                # 遍历匹配文件执行替换
                while read file; do
                    if [ -f "\$file" ]; then
                        sed -i 's/find_me/found_me/g' "\$file"
                    fi
                done < target_files.txt
                # 清理临时文件
                rm -f target_files.txt
            """
        // }
    }
}

如果是Windows架构的Jenkins节点，可替换为PowerShell实现：

stage('检索并替换目标字符串') {
    steps {
        sh """
            powershell -Command "Get-ChildItem -Path ./ -Recurse -Exclude .git | Select-String -Pattern 'find_me' | Select-Object -Unique Path | ForEach-Object { (Get-Content \$_.Path) -replace 'find_me', 'found_me' | Set-Content \$_.Path }"
        """
    }
}

方案2：纯Groovy实现（适用于禁用Shell执行的受限环境） #

如果你的Jenkins配置了严格的权限策略，不允许执行任意Shell命令，可使用内置Groovy API完成操作：

stage('检索并替换目标字符串') {
    steps {
        script {
            // 替换为你仓库克隆后的本地绝对路径
            def repoRoot = new File(pwd())
            def matchPattern = ~/find_me/
            def replaceContent = "found_me"
            
            // 递归遍历所有文件，自动跳过.git目录
            repoRoot.traverse(type: FileType.FILES, excludeDirFilter: ~/\.git/) { file ->
                def originContent = file.text
                // 先判断是否包含目标字符串，避免无效文件IO
                if (originContent =~ matchPattern) {
                    println "匹配到目标文件：${file.absolutePath}"
                    def newContent = originContent.replaceAll(matchPattern, replaceContent)
                    file.write(newContent)
                }
            }
        }
    }
}

通用注意事项 #

• 如果要避免修改二进制文件，可在检索规则中添加后缀过滤，比如排除*.zip、*.jar、*.png等二进制格式文件
• 如果匹配的字符串包含正则特殊字符（如/、*、.等），需要提前做转义处理：Shell方案中可更换sed的分隔符为|避免冲突，Groovy方案中可用Pattern.quote("你的匹配字符串")包裹匹配规则

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