在Jenkins声明式Pipeline中配置Go单体仓库的GOPATH问题

看起来你遇到的问题核心是GOPATH模式下的包路径结构不匹配，以及设置环境变量时的语法错误。我来一步步帮你理清解决方案：

问题根源分析 #

1. 包路径不匹配：GOPATH模式要求Go包必须放在$GOPATH/src/目录下，且包路径对应src下的子目录结构（比如my_repo/my_db对应$GOPATH/src/my_repo/my_db）。但Jenkins默认把代码拉取到workspace根目录，直接设置GOPATH=$WORKSPACE的话，你的代码实际在$WORKSPACE/而非$WORKSPACE/src/my_repo/，所以go build找不到包。
2. 权限错误原因：你脚本里的// GOPATH=...是语法错误——shell脚本的注释用#，不是//，shell把//当成可执行命令去跑，自然会报权限拒绝。

方案1：继续使用GOPATH模式 #

步骤1：调整代码目录结构 #

在Jenkins拉取代码后，把代码移动到$WORKSPACE/src/my_repo目录下（对应你的包路径前缀）：

pipeline {
    agent any
    environment {
        GOPATH = "${WORKSPACE}"
    }
    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }
        stage('Prepare GOPATH Structure') {
            steps {
                sh '''
                    # 创建src下的项目目录
                    mkdir -p $GOPATH/src/my_repo
                    # 把根目录的所有文件（包括隐藏文件）移动到src/my_repo下
                    mv $WORKSPACE/* $GOPATH/src/my_repo/ 2>/dev/null || true
                    mv $WORKSPACE/.* $GOPATH/src/my_repo/ 2>/dev/null || true
                '''
            }
        }
        stage('Build') {
            steps {
                sh '''
                    cd $GOPATH/src/my_repo
                    go build -o my_app ./path/to/your/main/package
                    golint ./...
                '''
            }
        }
    }
}

步骤2：修正环境变量设置 #

确保shell脚本里的注释用#，比如：

# 正确设置GOPATH
export GOPATH=$WORKSPACE
cd $GOPATH/src/my_repo
go build

方案2：推荐使用Go Modules（更简洁，无需GOPATH） #

现在Go 1.11+已经全面支持Go Modules，这是官方推荐的依赖管理方式，完全不需要依赖GOPATH，步骤更简单：

1. 本地初始化Modules：在你的项目根目录执行以下命令，生成go.mod和go.sum文件，然后提交到仓库：

go mod init my_repo
go mod tidy

2. Jenkins Pipeline中直接构建：不需要设置GOPATH，直接执行命令即可：

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }
        stage('Build') {
            steps {
                sh '''
                    # 下载依赖
                    go mod download
                    # 构建项目
                    go build -o my_app ./path/to/your/main/package
                    # 执行golint
                    golint ./...
                '''
            }
        }
    }
}

这种方式完全避开了GOPATH的路径问题，更符合现代Go项目的开发规范，维护起来也更省心。

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