怎样用容器跑开发环境？VS Code Dev Containers与Go语言环境搭建-Golang-PHP中文网

devcontainer.json是启用dev container功能的必需核心配置文件，必须置于项目根目录的.devcontainer/子目录下，且文件名严格为devcontainer.json；缺失或路径错误将导致vs code无法识别并提示“no dev container configuration found”。

怎样用容器跑开发环境？vs code dev containers与go语言环境搭建

devcontainer.json 是核心配置文件，不是可选附件，不配它就无法启用 Dev Container 功能。

Dev Container 启动失败：找不到 `devcontainer.json` 或镜像拉取超时

VS Code 不会自动创建开发容器配置——必须手动在项目根目录新建 .devcontainer/devcontainer.json。常见错误包括：

把文件放在项目外、或路径写成 devcontainer.json（缺 .devcontainer/ 目录）
用错模板：直接选 “Go” 模板可能拉取官方 mcr.microsoft.com/vscode/devcontainers/go:latest，但该镜像不含 dlv，调试会报 Command failed: dlv version
国内网络下拉镜像极慢甚至中断，docker pull 卡住时 VS Code 不提示具体原因，只显示“Building image…”无限转圈

解决方法：

手动初始化：Ctrl+Shift+P → 输入 Dev Containers: Add Development Container Configuration Files → 选 “Go” → 再手动编辑生成的 devcontainer.json
替换基础镜像为国内可用版本，例如："image": "ghcr.io/gitpod-io/workspace-full:latest"（含完整 Go 工具链）或自建镜像（见下节）
提前在终端运行 docker pull ghcr.io/gitpod-io/workspace-full:latest 验证连通性

`devcontainer.json` 必须显式安装 `gopls` 和 `dlv`

即使镜像里有 go 命令，gopls（语言服务器）和 dlv（调试器）默认不会预装。VS Code Go 扩展依赖它们提供跳转、补全、断点等能力，缺失即退化为纯文本编辑。

正确做法是在 devcontainer.json 的 features 或 postCreateCommand 中声明：

{
  "image": "golang:1.25",
  "features": {
    "ghcr.io/devcontainers/features/go:1": {}
  },
  "postCreateCommand": "go install golang.org/x/tools/gopls@latest && go install github.com/go-delve/delve/cmd/dlv@latest"
}

features 方式更干净，但需确认 feature 仓库支持你用的 Go 版本（如 go:1 对应 Go 1.23+）
postCreateCommand 更可控，但每次重建容器都会重跑安装——加 && go env -w GOBIN=$HOME/go/bin 确保二进制路径生效
别信“镜像自带 dlv”——多数精简镜像（如 golang:alpine）连 git 都没装，go install 会直接失败

Go Modules 在容器内失效：`go mod init` 报错或依赖无法解析

容器内 go mod 失败，90% 是代理问题。宿主机设了 GOPROXY，但容器是干净环境，go env 里仍是默认 https://proxy.golang.org,direct，国内根本连不上。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

修复方式只有两种，且必须选其一：

在 devcontainer.json 中通过 remoteEnv 注入：

"remoteEnv": {
  "GOPROXY": "https://goproxy.cn,direct",
  "GOSUMDB": "off"
}

或在 postCreateCommand 里执行：go env -w GOPROXY=https://goproxy.cn,direct GOSUMDB=off
切勿只改宿主机的 ~/.zshrc——容器启动时完全不读宿主 shell 配置
验证是否生效：Remote-Containers: Reopen in Container 后，在集成终端运行 go env | grep GOPROXY

调试器连接失败：`dlv` 启动后立即退出，或 VS Code 提示 “Could not attach to process”

根本原因：容器默认不暴露调试端口，且 dlv 默认监听 127.0.0.1:2345，宿主机无法访问。

必须同步做三件事：

在 devcontainer.json 中开放端口："forwardPorts": [2345]
启动 dlv 时绑定 0.0.0.0：dlv debug --headless --listen=:2345 --api-version=2
确保 launch.json 的 port 与上述一致，并设 "mode": "attach" 或 "mode": "debug"（非 exec）
若用 dlv dap（推荐），还需在 devcontainer.json 中加 "customizations": { "vscode": { "extensions": ["golang.go"] } } 并确认插件启用