直接用golang官方镜像启动开发环境开箱即用，预装go、git、curl等工具并配置好GOPATH/GOROOT；推荐命令docker run -it --rm -v $(pwd):/go/src/app -w /go/src/app golang:1.26-alpine bash，需挂载匹配Go工作区路径、设置代理GOPROXY、避免使用latest标签，生产环境须用多阶段构建精简镜像。
直接用 golang 官方镜像启动开发环境
不需要自己写 Dockerfile 或编译 Go，golang 官方镜像开箱即用。它预装了 go、git、curl 等基础工具，且已设置好 GOPATH 和 GOROOT。
最简命令：
docker run -it --rm -v $(pwd):/go/src/app -w /go/src/app golang:1.26-alpine bash
说明：
-
-v $(pwd):/go/src/app：把当前目录挂载进容器，路径需匹配 Go 工作区约定（/go/src/xxx） -
-w /go/src/app：设为工作目录，避免每次手动cd - 推荐用带版本号的镜像（如
golang:1.26-alpine），不用latest—— 否则某天go version突然变 1.27，CI 可能崩 - Alpine 版本轻量但缺少
glibc，若项目依赖 cgo 或某些 C 库（如 SQLite、OpenSSL），改用golang:1.26-bullseye
挂载源码后快速验证 go mod 和依赖拉取
进容器后第一件事不是写代码，而是确认模块代理是否生效。国内不配代理，go mod download 极大概率卡住或超时。
立即学习“go语言免费学习笔记（深入）”；
执行以下命令检查并修复：
go env -w GOPROXY=https://goproxy.cn,direct<br>go env -w GOSUMDB=sum.golang.google.cn
然后测试：
go mod init example.com/hello<br>go get github.com/gin-gonic/gin@v1.12.0
常见错误现象：
-
go: github.com/gin-gonic/gin@v1.12.0: reading https://proxy.golang.org/...: 403 Forbidden→ 代理没生效或没加,direct -
verifying github.com/xxx@vX.Y.Z: checksum mismatch→GOSUMDB没关或设错，应为sum.golang.google.cn而非off - 用
go run main.go报cannot find module providing package→ 当前目录不在GO111MODULE=on下的合法模块路径（比如不在/go/src/xxx或没go.mod）
用 air 实现热重载，避免反复 exit/重新 docker run
每次改一行代码就 exit 再 docker run 太折腾。用 air 可监听文件变化自动重启。
操作步骤：
- 进容器后执行：
go install github.com/cosmtrek/air@latest - 在项目根目录写
.air.toml，关键配置项：
[build]<br> cmd = "go build -o ./app ."<br> bin = "./app"<br>[watch]<br> include_ext = ["go", "tpl", "tmpl", "html"]
然后运行：air
注意点：
-
air默认监听当前目录，所以必须在挂载的项目根目录下运行 - 如果程序绑定
localhost:8080，容器内能跑通，但宿主机访问不到 —— 记得docker run加-p 8080:8080 - Alpine 镜像里
air编译可能失败（缺gcc），优先用golang:1.26-bullseye镜像安装
别把开发镜像当生产镜像用
直接 docker run golang:1.26-alpine 是为了写代码，不是为了上线。生产镜像必须更小、更安全。
典型错误做法：
- 用同一个镜像既
go build又./app→ 镜像里留着 Go 编译器、源码、SDK，体积翻倍，攻击面扩大 - 把
air、vim、git打进生产镜像 → 完全没必要，还增加漏洞风险
正确姿势是多阶段构建：
FROM golang:1.26-bullseye AS builder<br>WORKDIR /app<br>COPY . .<br>RUN go build -o server .<br><br>FROM debian:bullseye-slim<br>WORKDIR /root<br>COPY --from=builder /app/server .<br>CMD ["./server"]
最终镜像不含 Go 工具链，只有二进制和 libc，大小通常压到 15MB 以内。这个步骤不能省，也不能靠“先 commit 再 push”糊弄过去。
