官方golang镜像开箱即用，预设goroot、gopath和path；自建镜像易踩goroot错误、权限问题及cgo缺失三坑；开发需挂载本地目录并设置工作路径，交叉编译须注意goos与cgo_enabled配合。
直接用官方 golang 镜像就能跑，别自己装 Go
官方镜像已预设 GOROOT、GOPATH 和 PATH，go version、go mod init 开箱即用。自己基于 ubuntu 或 alpine 从头装 Go，容易踩三类坑：GOROOT 指向错误导致 go build 找不到标准库；go 二进制无执行权限；CGO_ENABLED=1 但缺 libc6-dev，一跑 cgo 就报错 exec format error 或 cannot find -lc。
官方镜像默认启用 CGO_ENABLED=1，且已安装 gcc 和 musl-dev（Alpine）或 build-essential（Debian），交叉编译时不用额外装工具链——除非你关了 CGO。
docker run 启动开发容器必须挂载本地目录
不挂载，改完代码容器一退出就丢。关键参数只有三个：
-
-v $(pwd):/workspace（Linux/macOS）或-v ${PWD}:/workspace（PowerShell），必须用绝对路径 -
-w /workspace，否则go run报no Go files in current directory -
--rm可选，适合临时调试；长期开发建议去掉，方便docker exec -it复用
示例命令：
docker run -it --rm \ -v $(pwd):/workspace \ -w /workspace \ golang:1.22
进去后直接 go run main.go，宿主机改代码，容器里立刻生效。
交叉编译失败？先看 GOOS 和 CGO_ENABLED
容器里 go build 出来的二进制默认是 Linux 可执行文件。想在 macOS 或 Windows 上运行，必须显式设置目标平台：
- 纯 Go 项目（无 cgo）：直接设
GOOS=darwin或GOOS=windows即可 - 含 cgo 的项目（如连 PostgreSQL、SQLite）：
CGO_ENABLED=0才能跨平台，否则会报cross-compilation not allowed - 若必须保留 cgo（比如要调系统库），就得用对应平台的构建镜像，例如
golang:1.22-alpine+apk add gcc musl-dev编译GOOS=linux，或换golang:1.22-bullseye编译GOOS=windows（需 mingw 工具链）
常见误操作：GOOS=darwin go build 不加 CGO_ENABLED=0，结果卡在 # runtime/cgo 报错。
开发镜像里缺 git、dlv、ca-certificates？补上再 commit
裸 golang:1.22 镜像精简得只剩编译器，go mod download 会因缺证书失败，git clone 报 command not found，dlv debug 直接提示 executable file not found。
快速补全方式（进容器后执行）：
- Debian 系：
apt update && apt install -y git curl vim ca-certificates - Alpine 系：
apk add --no-cache git curl vim ca-certificates - 装 Delve：
go install github.com/go-delve/delve/cmd/dlv@latest（注意用go install，不是go get）
装完别忘了 docker commit -m "add dev tools" CONTAINER_ID my-golang-dev，否则重启容器工具全丢。后续用 docker run -it my-golang-dev 就不用重复装。
真正麻烦的不是装工具，而是挂载 /go/pkg/mod 和 /go/cache ——漏掉它们，每次重拉依赖都要十几秒，而且模块缓存无法复用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
