官方golang镜像无法直接用于开发：缺git、curl、gcc、bash及delve，导致无法克隆、编译、调试；需基于golang:1.22-slim安装工具链与dlv，并配置VS Code路径映射和go mod缓存卷。
直接用官方 golang 镜像就能跑开发环境，但默认镜像不含 git、make、调试器或 IDE 插件依赖，裸用会卡在 clone 项目、运行测试、调试断点这些基础环节。
为什么不能直接 docker run -it golang:1.22 就开干
官方镜像基于 debian:slim 或 alpine，精简得过了头：没有 git（拉不下私有仓库）、没 curl（装不了工具链）、没 gcc（编译 cgo 失败）、没 vim 或 bash（连编辑文件都费劲）。更关键的是，它不预装 delve（dlv），VS Code 的 Go 扩展连不上容器调试端口。
-
golang:1.22-alpine缺少git和bash，得手动apk add git bash -
golang:1.22-slim虽有bash，但缺git、gcc、libc6-dev，cgo 项目一编译就报exec: "gcc": executable file not found - 所有官方镜像都不含
dlv，必须自己go install github.com/go-delve/delve/cmd/dlv@latest
推荐的最小可用开发镜像写法（Debian 基础）
别魔改太多层，用多阶段构建把工具链和调试器一次性装齐。重点是保留 /go 工作区结构，和宿主机 volume 挂载路径对齐。
FROM golang:1.22-slim <h1>安装基础工具链</h1><p>RUN apt-get update && apt-get install -y \ git \ curl \ gcc \ libc6-dev \ bash \ && rm -rf /var/lib/apt/lists/*</p><h1>安装 delve（调试必需）</h1><p>RUN go install github.com/go-delve/delve/cmd/dlv@latest</p><h1>设置 GOPATH 和工作目录（保持与官方一致）</h1><p>ENV GOPATH=/go WORKDIR /go/src</p><h1>可选：暴露调试端口</h1><p>EXPOSE 2345</p>
构建后用 docker build -t my-golang-dev .，再挂载本地代码目录启动：
docker run -it \ -v $(pwd):/go/src/myproject \ -w /go/src/myproject \ -p 2345:2345 \ my-golang-dev
VS Code 连接容器调试的关键配置
不是装了 dlv 就能调试，VS Code 的 launch.json 必须匹配容器网络和路径映射。常见错误是路径没对齐，导致断点不命中。
- 容器内
dlv启动命令要用--headless --continue --accept-multiclient --api-version=2 --addr=:2345 -
launch.json中program字段填容器内路径，如/go/src/myproject/main.go -
env里加"GOPATH": "/go"，否则go mod找不到依赖 -
substitutePath必须配，把容器路径映射回宿主机，例如：{"from":"/go/src/myproject","to":"${workspaceFolder}"}
挂载 go mod 缓存避免重复下载
每次重启容器都重下依赖太慢。把 /go/pkg/mod 单独挂成命名卷，既复用缓存又不污染项目目录。
docker run -it \ -v $(pwd):/go/src/myproject \ -v go-mod-cache:/go/pkg/mod \ -w /go/src/myproject \ my-golang-dev
第一次运行后，用 docker volume create go-mod-cache 创建卷。注意不要挂 /go 整体，否则 go.sum 和 go.mod 修改会被覆盖。
真正麻烦的是 cgo 项目——你得确认容器里 pkg-config 和对应 C 库头文件全在，比如 SQLite 项目要额外 apt-get install libsqlite3-dev。这种定制化需求，往往比镜像本身更花时间。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
