官方golang镜像可直接交互运行，需挂载本地目录和go mod缓存卷以复用依赖；构建产物建议用docker cp导出或stdout管道接收；Dockerfile中应分步COPY go.mod/go.sum与源码以提升缓存效率；dlv调试须添加SYS_PTRACE权限、监听所有地址并映射端口，Alpine镜像需预装git。
用官方 golang 镜像启动交互式开发容器
直接运行 docker run -it --rm golang:1.22 就能进一个带完整 Go 工具链的 shell，go version、go mod init 全都可用。关键不是“能不能跑”，而是怎么让本地代码和容器联动——默认容器里是空的，你得把项目目录挂进去。
常见错误是只挂了源码没挂 go mod 缓存，导致每次 go build 都重新下载依赖，慢且浪费流量。建议加两个挂载点：
-
-v $(pwd):/workspace：把当前目录映射为容器内/workspace -
-v go-mod-cache:/go/pkg/mod：复用已下载的模块（Docker volume 自动管理）
顺手加上工作目录和终端配置：-w /workspace -e GOPATH=/workspace，避免 go 命令找不到 go.mod 或误写入系统默认路径。
go build 产物在容器里生成，但想在宿主机运行怎么办
Go 的二进制是静态链接的，跨平台编译没问题，但默认构建出的可执行文件权限可能被 Docker 挂载机制限制（尤其 macOS / Windows 宿主机）。最稳的方式不是直接运行容器里的二进制，而是用 docker cp 拷出来：
立即学习“go语言免费学习笔记（深入）”；
docker cp:/workspace/myapp ./myapp
或者更干脆，在 docker run 时用 --entrypoint 覆盖默认行为，让容器构建完立刻退出并输出二进制到 stdout：
docker run --rm -v $(pwd):/workspace -w /workspace golang:1.22 sh -c "go build -o /dev/stdout ."
这样可以用管道接住输出：docker run ... | dd of=./myapp bs=1（注意加 bs=1 防止截断）。
Dockerfile 中 COPY 和 ADD 的顺序影响构建速度
Go 项目构建缓存失效的头号原因是把 go.mod 和源码一起 COPY。正确做法是分两步：
- 先
COPY go.mod go.sum .，再RUN go mod download—— 这步能利用 Docker 层缓存，只要依赖没变，后续构建跳过下载 - 再
COPY . .，最后RUN go build
如果项目用了 replace 指向本地路径（比如 replace example.com/foo => ../foo），那 go mod download 会失败——因为外部镜像里根本没有 ../foo。此时必须把被 replace 的模块也 COPY 进来，或改用 go mod edit -replace 在构建时动态修改。
调试时容器内 dlv 启动失败的常见原因
用 delve 调试需要容器开启 ptrace 权限，否则报错 could not attach to pid XXX: operation not permitted。启动容器时必须加参数：
docker run --cap-add=SYS_PTRACE --security-opt seccomp=unconfined ...
另外注意：Delve 默认监听 127.0.0.1:2345，容器内 localhost 是它自己，宿主机连不上。要改成 --headless --listen=:2345（冒号开头表示监听所有地址），再配 -p 2345:2345 端口映射。VS Code 的 launch.json 里 port 填 2345，host 填 localhost 即可连上。
还有一个隐藏坑：某些 Alpine 基础镜像（如 golang:alpine）默认不带 git，而 dlv 编译时若检测到 git 会自动嵌入版本信息；缺失时虽不影响运行，但 VS Code 调试器可能因无法读取调试元数据而卡在 “Starting” 状态。装个 apk add --no-cache git 更稳妥。
