根本原因是Drone默认不设置GOPATH且克隆路径不在$GOPATH/src下，同时未启用GO111MODULE=on，导致go build沿GOPATH查找失败；解决方式是统一配置GO111MODULE=on、go mod download，并正确设置workspace路径以匹配模块结构。
Drone 能直接替代 Jenkins 做 Golang 工程的 CI/CD，但必须用对 Runner 类型、.drone.yml 结构和 GOPATH 配置，否则 go build 会报找不到包或 go test 失败。
为什么 Golang 项目在 Drone 中常出现 cannot find package 错误
根本原因不是代码问题，而是 Drone 默认不自动设置 GOPATH 或模块路径。Golang 1.11+ 虽支持 module，但 Drone 的 golang 镜像（如 golang:1.21）默认仍以 GOPATH 模式运行，且工作目录不是 $GOPATH/src 下的合法路径。
- Drone 克隆代码到
/drone/src/xxx，但该路径不在$GOPATH/src内 →go build找不到本地依赖 - 未显式启用 Go modules（
GO111MODULE=on）→ 仍尝试走 GOPATH 查找 - 多模块项目（含
replace或require ./submodule）时，路径解析更易出错
解决方式不是改镜像，而是统一用 GO111MODULE=on + 显式 go mod download：
pipeline:
test:
image: golang:1.21
commands:
- export GO111MODULE=on
- go mod download
- go test -v ./...
.drone.yml 中 workspace 配置对 Golang 构建的实际影响
workspace 不是可选项，而是 Golang 项目稳定构建的关键开关。它控制源码挂载位置和跨步骤共享路径，直接影响 go build 输出、go install 二进制存放、以及 go run 调试是否可用。
立即学习“go语言免费学习笔记（深入）”；
- 不配
workspace：每次 step 都在全新容器中，go build -o bin/app生成的文件在 step 结束后即销毁 - 配了但
path错误（如写成path: src/github.com/user/repo）：Drone 会把代码克隆到该子路径，但go mod init初始化的 module 名可能不匹配，导致 import 解析失败 - 推荐配置（适配标准 Go module 结构）：
workspace: base: /go path: src/github.com/your-org/your-repo <p>pipeline: build: image: golang:1.21 commands:</p><ul><li>export GO111MODULE=on</li><li>go build -o bin/your-app .
这样 /go/src/github.com/your-org/your-repo 就是合法 GOPATH 路径，同时兼容 module 模式。
如何让 Drone Runner 正确执行 go install 并保留二进制
go install 默认把可执行文件放到 $GOPATH/bin，而 Drone 容器退出后该目录就没了。若想复用构建产物（比如后续 step 用 your-app --version），必须显式指定 -o 或改 GOBIN。
- 错误写法（产物丢失）：
go install ./cmd/your-app - 正确写法（输出到 workspace 可共享路径）：
go build -o bin/your-app ./cmd/your-app - 或统一设置
GOBIN（需确保bin/目录存在）：
- mkdir -p bin - export GOBIN=$PWD/bin - go install ./cmd/your-app
注意：Drone 的 volume 挂载只在单个 pipeline 内有效，跨 pipeline（如从 build 到 deploy）仍需用 docker build 打包或 rsync 推送。
Golang 构建后如何安全地部署到远程服务器（不用 Docker）
很多 Golang 项目最终只需一个静态二进制，直接 rsync 部署最轻量。但 Drone 默认不带 rsync 或 SSH key，必须手动注入。
- 用
plugins/rsync插件最稳妥（官方维护，支持密钥加密）：
deploy:
image: plugins/rsync
settings:
host: your-server.com
user: deploy
port: 22
source: bin/your-app
target: /opt/your-app/bin/
secrets: [ ssh_key ]
- 自己写脚本也行，但必须用
from_secret注入密钥，不能硬编码：
- echo "$$SSH_KEY" > /tmp/id_rsa - chmod 600 /tmp/id_rsa - rsync -avz -e "ssh -i /tmp/id_rsa -o StrictHostKeyChecking=no" bin/your-app deploy@your-server.com:/opt/your-app/bin/
这里 $$SSH_KEY 是 Drone secret，需提前通过 UI 或 CLI 添加，且变量名大小写敏感、不能含下划线。
真正容易被忽略的是：Golang 二进制的 CGO_ENABLED 默认为 1，如果目标服务器没装 libc 或 musl，rsync 过去会直接报 not found —— 记得加 CGO_ENABLED=0 编译，尤其是部署到 Alpine 容器或极简 Linux 环境时。
