根本原因是官方Runner镜像未预装Go，PATH中无go命令；应优先使用golang官方镜像（如golang:1.22-alpine），避免自行安装或依赖before_script配置。
GitLab Runner里go命令报“command not found”怎么办
根本原因不是Runner没装Go，而是绝大多数官方Runner镜像（比如ubuntu:22.04或alpine:latest）压根不预装go。你看到的“找不到命令”，其实是容器启动后PATH里真没这个二进制。
实操建议优先用golang官方镜像作为image，而不是自己折腾安装：
- 在
.gitlab-ci.yml最顶层加image: golang:1.22-alpine（推荐Alpine版，体积小、启动快） - 避免用
before_script去apt install golang——不同基础镜像包名不一致（Ubuntu是golang-go，Alpine是go），还容易因缓存导致版本混乱 - 如果必须复用已有Runner（比如公司统一Ubuntu镜像），那就得在
before_script里明确下载解压Go二进制：before_script: - wget https://go.dev/dl/go1.22.5.linux-amd64.tar.gz - rm -rf /usr/local/go - tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz - export PATH=$PATH:/usr/local/go/bin
go mod download在CI里频繁超时或失败
私有CI环境常因网络策略（如禁止外网、代理未配置）或GOPROXY设置不当，导致go mod download卡住或返回403。这不是Go本身问题，是环境隔离带来的副作用。
关键动作是显式控制模块代理和校验：
立即学习“go语言免费学习笔记（深入）”；
- 在
.gitlab-ci.yml中为每个job设置环境变量：variables: GOPROXY: https://proxy.golang.org,direct GOSUMDB: sum.golang.org
若内网有自建代理（如Athens），把GOPROXY换成http://athens.company.local - 禁用
GOSUMDB风险极高，只在完全可信的离线环境临时设为off，否则go build可能拒绝加载模块 - 加
go mod download -x（开启调试）到script里，能快速定位是DNS解析失败、连接超时还是认证拒绝
Runner执行go test时提示“cannot find package”
这通常发生在项目结构非标准（比如main.go不在仓库根目录）或GO111MODULE行为被意外覆盖时。Go 1.16+默认启用module模式，但某些旧Runner环境可能仍残留GO111MODULE=auto逻辑。
确保测试路径和模块上下文匹配：
- 检查
go.mod是否在仓库根目录；如果不是，用cd切到含go.mod的目录再跑go test - 强制开启module模式：
GO111MODULE=on go test ./...（别信auto，CI里一律显式设on） - 私有模块（如
gitlab.company.com/group/project）必须确保go.mod里写的是完整域名路径，且Runner能通过SSH或HTTPS访问该GitLab实例（常见坑：Runner用HTTP拉代码，但GitLab只开HTTPS）
构建产物体积大、上传慢，怎么精简go build输出
默认go build生成的二进制带调试符号、未剥离，Linux下动辄20MB+。CI流水线上传耗时长，还占Runner磁盘空间。
三个参数组合就能压到1/3体积：
- 加
-ldflags="-s -w"：去掉符号表（-s）和DWARF调试信息（-w） - 用
CGO_ENABLED=0编译：彻底禁用cgo，避免动态链接libc，生成纯静态可执行文件（尤其适合Alpine镜像） - 示例命令：
CGO_ENABLED=0 go build -ldflags="-s -w" -o bin/app .
- 注意：如果代码用了
net包且依赖系统DNS（如net.LookupIP），CGO_ENABLED=0可能导致解析失败，此时需保留cgo并用go env -w GODEBUG=netdns=go强制Go DNS解析器
私有CI里最容易被忽略的，是Runner节点上$GOCACHE和$GOPATH/pkg/mod的磁盘清理策略——没人管的话，一个月就能吃掉几十GB。别只盯着构建脚本，得定期gitlab-runner cleanup --all-runners或者在config.toml里配cache_dir自动轮转。
