GO111MODULE=on是硬性前提，未开启则go mod命令不生效、gopls报“failed to load packages”；GOPROXY必须设为https://goproxy.cn,direct，缺direct会导致私有模块401/404；devcontainer.json须配置features、forwardPorts和postCreateCommand三要素。
GO111MODULE=on 是硬性前提，不是可选项
没开这个，go mod 命令压根不生效，VS Code 里 gopls 会持续报 “failed to load packages”，连 import 补全都失效。现象很典型：go run main.go 能跑，但 go mod init 没反应、不生成 go.mod。
原因在于旧环境（比如某些 CI 镜像、未更新的 Docker 容器）仍默认 GO111MODULE=auto，它靠路径判断是否启用模块——在 /tmp 或非 GOPATH/src 下可能直接跳过。稳妥做法只有一条：
-
go env -w GO111MODULE=on（必须在容器初始化阶段执行） - 验证：进容器后运行
go env GO111MODULE，输出必须是on - 如果项目已在
GOPATH/src下，开启后会强制走模块路径，不再受GOPATH干扰
GOPROXY 必须配 https://goproxy.cn,direct
国内直连 proxy.golang.org 几乎必超时或返回 403，表现为 go get 卡住、go mod tidy 无响应、VS Code 右下角反复提示 “Fetching dependencies…”。
direct 不是可选后缀，缺了会导致私有模块（如 git.internal.company.com/lib/foo）被代理拦截，报错 401 Unauthorized 或 404 Not Found：
立即学习“go语言免费学习笔记（深入）”；
go env -w GOPROXY=https://goproxy.cn,direct- 验证：运行
go env GOPROXY，输出必须严格匹配该字符串 - 若用
goproxy.io或mirrors.aliyun.com，需确认其 direct 回源策略是否兼容你公司的私有 Git 认证方式
devcontainer.json 里漏掉这三项，调试和依赖管理就断链
90% 的 VS Code Remote-Containers 连接失败，不是镜像问题，而是 .devcontainer/devcontainer.json 配置缺关键项。Delve 调试端口不通、go mod tidy 不自动执行、gopls 加载失败，基本都源于此：
-
"features"字段缺失 → 即使镜像预装了dlv和gopls，VS Code 也不会激活 Go 扩展支持，必须显式加："features": { "ghcr.io/devcontainers/features/go:1": {} } -
"forwardPorts"缺[2345]→ Delve 默认监听 2345，不转发就无法从本地连接调试器 -
"postCreateCommand"没触发模块初始化 → 推荐写："go mod init example.com/project || true"，防止首次打开因无go.mod报错；再补一句"go mod tidy -v"确保依赖就绪
go mod tidy 不下载依赖？先检查 import 是否真实生效
执行 go mod tidy 后 go.sum 为空、依赖没拉下来，大概率不是配置问题，而是代码本身没触发模块加载机制：
-
import语句必须在.go文件中真实存在，不能是注释、不能是字符串字面量（如"github.com/gin-gonic/gin"） - 确保至少一个函数里实际用了该包，例如
gin.Default()；否则老版本 Go 可能因 “imported and not used” 警告而跳过解析 - 运行
go list -m all验证模块状态，如果报错，gopls必然同步失败 - 刚初始化完项目，别急着重启编辑器，先在终端手动跑一遍
go mod tidy -v，看卡在哪一步——常卡在 git clone 私有仓库或证书校验上
最易被忽略的一点：DevContainer 启动后，VS Code 默认 attach 到容器，但 gopls 初始化是异步的，且依赖 go.mod 和缓存完全就绪。很多人看到补全没反应就重装插件，其实只需按 Ctrl+Shift+P → 输入 “Go: Restart Language Server” 强制刷新一次。
