如何让Jenkins多分支项目生成更短的工作区名称？

当然有办法解决这个问题！那串长串字符是Jenkins多分支项目默认添加的唯一UUID，用来避免不同分支（或不同仓库的同名分支）出现工作区路径冲突。下面给你几个可行的解决方案，从全局配置到项目级调整，还有优化你现有Jenkinsfile的方法：

方案1：全局修改多分支项目的工作区模板（所有项目生效） #

如果你希望所有多分支项目都生成短工作区名称，可以修改Jenkins的全局配置：

• 进入Jenkins管理界面，点击「Configure System」（系统配置）
• 滚动到「Multi-branch Project Configuration」（多分支项目配置）区域
• 找到「Workspace Name Template」（工作区名称模板），默认值是${ITEM_FULL_NAME}${UUID}
• 将模板修改为你需要的格式，比如直接去掉${UUID}，改成${ITEM_FULL_NAME}，或者自定义更简洁的格式如${ITEM_NAME}-${BRANCH_NAME}
• 保存配置即可，新的分支构建会使用新的工作区路径

注意：这个修改会影响所有多分支项目，如果你的环境存在不同仓库的同名分支，去掉UUID可能会导致工作区冲突，需要确认你的场景不会出现这种情况。

方案2：单个多分支项目单独配置（仅当前项目生效） #

如果只想调整当前这个项目的工作区名称，可以在项目内单独配置：

• 进入你的多分支项目页面，点击「Configure」（配置）
• 找到「Branch Sources」（分支源）部分，点击「Advanced」（高级）按钮展开更多选项
• 在「Workspace Template」（工作区模板）中输入自定义路径，比如${JOB_NAME}/${BRANCH_NAME}，这样就不会自动添加UUID后缀了
• 保存配置，后续构建就会使用你指定的短路径

方案3：优化你现有的Jenkinsfile代码 #

你的Jenkinsfile已经在尝试自定义工作区，但可以简化逻辑，让代码更清晰：

#!/usr/bin/env groovy
env.PATH = env.PATH + ";c:\\Windows\\System32"

def call(String label = null, Closure body) {
    node(label) {
        // 构建基础的短工作区路径：Jenkins根工作区 + 项目名（替换斜杠为短横）-分支名
        def baseWorkspace = "${env.JENKINS_HOME}\\workspace\\${env.JOB_NAME.replaceAll(/[\\/]/, '-')}-${env.BRANCH_NAME}"
        def customWorkspace = baseWorkspace
        
        // 如果是并行构建，保留原工作区的@后缀（比如@2），避免并行任务冲突
        if (env.WORKSPACE?.contains('@')) {
            def parallelSuffix = env.WORKSPACE.split('@')[-1]
            customWorkspace = "${baseWorkspace}@${parallelSuffix}"
        }
        
        // 使用自定义工作区执行流水线逻辑
        ws(customWorkspace) {
            body()
        }
    }
}

pipeline {
    // 这里添加你的流水线阶段逻辑
    agent none
    stages {
        stage('Build') {
            agent { label 'your-agent-label' }
            steps {
                script {
                    // 调用自定义的node逻辑
                    call('your-agent-label') {
                        // 你的构建步骤，比如checkout、build等
                        checkout scm
                        echo "当前工作区路径：${pwd()}"
                    }
                }
            }
        }
    }
}

这个版本的代码直接基于Jenkins环境变量构建路径，避免了拆分现有路径的复杂操作，同时保留了并行构建所需的后缀，更稳定可靠。

重要注意事项 #

• 无论使用哪种方案，去掉UUID后要确保不会有不同分支/项目使用相同工作区路径，否则会导致构建过程中文件被覆盖、冲突等问题。
• 如果你的项目有并行构建需求，一定要保留@数字的后缀，否则多个并行任务会共用同一个工作区，导致构建失败。
• 全局配置修改前建议先在单个项目测试，确认没有问题后再推广到所有项目。

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