Go插件无提示主因是gopls未安装或工作区未识别为Go项目；需运行Go: Install/Update Tools安装gopls，确保含go.mod或.go文件，配置GOPROXY/GOPRIVATE解决代理问题，调试需正确设置dlv和launch.json，格式化需指定go.formatTool并避免扩展冲突。
Go extension 安装后还是没代码提示？
不是插件没装，而是 gopls 没跑起来，或者工作区没识别为 Go 项目。VSCode 的 Go 插件（golang.go）默认依赖 gopls 提供智能提示、跳转、格式化等功能，但它不会自动下载或静默启动。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Go: Install/Update Tools，勾选gopls后确认 —— 这步漏掉，90% 的“没提示”就卡在这儿 - 确保当前文件夹里有
go.mod（哪怕空的），或者至少有一个.go文件且 VSCode 已在该目录下打开——gopls需要明确的 module root，单纯打开单个.go文件不触发完整语言服务 - 检查状态栏右下角是否显示
Go和gopls版本号；如果显示Initializing...超过 10 秒，大概率是模块路径错误或代理问题（见下一条）
go mod download 卡住 / gopls 报 failed to load view 错误
本质是 gopls 在解析依赖时无法拉取 module 信息，常见于国内网络环境，但很多人误以为是配置问题，反复重装插件。
- 在终端中手动执行
go env -w GOPROXY=https://proxy.golang.org,direct改为国内可用地址，例如：go env -w GOPROXY=https://goproxy.cn,direct - 如果项目用了私有仓库（如公司内网 Git），必须补全
go env -w GOPRIVATE=git.example.com/*，否则gopls会试图走代理去查它，直接超时失败 -
gopls默认启用cache模式，若频繁切换分支或修改go.mod，可临时加"go.toolsEnvVars": {"GOPLS_CACHE_DIR": ""}清缓存（不建议长期关闭）
调试时断点不命中或显示 “Unverified breakpoint”
不是 dlv 没装，而是 VSCode 启动调试器时用的构建参数和你本地习惯不一致，尤其是涉及 module、cgo、race 等场景。
- 确认已安装
dlv：运行go install github.com/go-delve/delve/cmd/dlv@latest，然后在终端执行dlv version验证路径是否在$PATH中 - 检查
.vscode/launch.json中的mode：调试单文件用"mode": "test"或"mode": "exec"，调试整个 module 必须用"mode": "auto"或显式写"mode": "exec"并指定"program": "./main.go" - cgo 项目必须加
"env": {"CGO_ENABLED": "1"}，否则 dlv 加载符号失败，断点全部失效；同时确保系统已装好 gcc（macOS 装xcode-select --install，Ubuntu 装build-essential）
format on save 不生效或用错 formatter
VSCode 默认调用 gofmt，但 Go 社区现在主推 goimports 或 gofumpt，而插件不会自动切过去，需要显式声明。
立即学习“go语言免费学习笔记（深入）”；
- 在用户或工作区设置中添加：
"go.formatTool": "goimports"（需先go install golang.org/x/tools/cmd/goimports@latest） - 如果想严格禁用自动 import 排序（比如团队用
gofumports），改用"go.formatTool": "gofumports"，注意拼写，少个s就报 command not found - 启用 format on save 前，务必关掉其他格式化扩展（如 Prettier），它们会抢在 Go 插件前处理
.go文件，导致保存后代码被二次破坏
真正麻烦的从来不是装插件，而是 gopls 和 go 命令行工具之间的信任链——它依赖正确的 GOPATH、GOPROXY、GOPRIVATE，还悄悄读取 go env 输出。改一个环境变量，可能让提示、调试、格式化三者同时恢复，也可能只修好其中一项。别猜，开终端，go env 和 ps aux | grep gopls 多看两眼。
