官方golang镜像开箱即用，无需自行配置GOROOT、PATH等；挂载本地目录实现代码热更新；交叉编译需注意GOOS/CGO_ENABLED；dlv调试须绑定0.0.0.0并映射端口。
用官方 golang 镜像启动交互式开发容器
直接运行 docker run -it golang:1.22 就能进一个带完整 Go 工具链的 shell，go version、go mod init 全都可用。关键是要挂载本地代码目录，否则改完代码容器一关就丢：
docker run -it \ -v $(pwd):/workspace \ -w /workspace \ golang:1.22
这样你在宿主机写的 main.go 会实时出现在容器里，go run main.go 直接生效。注意路径必须是绝对路径，$(pwd) 在 Linux/macOS 可用，Windows PowerShell 要换成 ${PWD}。
为什么别用 FROM ubuntu 自己装 Go
自己装容易踩三个坑：GOROOT 配错、go 二进制权限问题、交叉编译支持缺失。官方镜像已预设好所有环境变量：GOPATH=/go、GOROOT=/usr/local/go、PATH 包含 /usr/local/go/bin。你只需要关心项目路径，不用碰底层配置。
- 自建镜像体积多出 300MB+（要装
curl、tar、ca-certificates） -
go test -race在非官方镜像里可能报failed to open /proc/sys/kernel/perf_event_paranoid - 官方镜像默认启用
CGO_ENABLED=1，自己装容易漏掉libc6-dev导致 cgo 失败
go build 输出二进制在容器里跑不了？检查 GOOS 和 CGO_ENABLED
容器里编译出来的二进制默认是 Linux 可执行文件，如果想在 macOS 或 Windows 宿主机运行，必须显式交叉编译：
立即学习“go语言免费学习笔记（深入）”；
GOOS=darwin GOARCH=arm64 go build -o myapp-darwin main.go
如果项目依赖 cgo（比如连 PostgreSQL），交叉编译会失败，此时要么关掉 cgo：CGO_ENABLED=0 GOOS=darwin go build ...，要么用对应平台的构建容器（如 golang:1.22-alpine 配 apk add gcc musl-dev）。
常见错误：在容器里执行 ./myapp 报 No such file or directory —— 实际是动态链接器不匹配，不是文件不存在。用 file myapp 看输出是否含 ELF 64-bit LSB pie executable, x86-64，再用 ldd myapp 确认依赖库路径。
调试时 dlv 连不上？容器得开两个端口
dlv 默认监听 localhost:2345，但容器内 localhost 不等于宿主机，必须绑定到 0.0.0.0 并暴露端口：
docker run -it \ -v $(pwd):/workspace \ -w /workspace \ -p 2345:2345 \ golang:1.22 \ dlv debug --headless --listen=:2345 --api-version=2 --accept-multiclient
然后在 VS Code 的 launch.json 里填 "port": 2345，不要改 "host"。如果还连不上，检查容器里 dlv 版本是否和 IDE 插件兼容（1.22 镜像自带的是 dlv v1.21.0，够用；太新反而可能不识别）。
真正麻烦的是调试带 syscall 的代码（比如 os/exec 启进程），容器网络 namespace 和宿主机隔离，dlv 断点可能卡在 fork 后的子进程里——这时候得加 --continue 参数让调试器自动跟进。
