vs code需手动安装go扩展并配置go路径才能启用跳转、格式化等功能；必须禁用内置go支持，仅用golang.go扩展；关键设置包括启用gopls、设formattool为goimports、自动更新工具等。
vs code 本身不自带 go 语言支持，必须手动安装扩展并配置 go 命令行工具路径，否则所有功能（如跳转、格式化、诊断）都会失效。
确认本地已安装 Go 并能被 VS Code 找到
VS Code 的 Go 扩展依赖系统 PATH 中的 go 可执行文件。如果 go version 在终端能正常输出，但 VS Code 里提示 “Go binary not found”，大概率是 VS Code 启动方式导致 PATH 未继承（尤其在 macOS/Linux 图形界面下）。
- macOS：用
code --new-window从终端启动 VS Code，而非点击 Dock 图标 - Linux：确保桌面环境（如 GNOME）的 PATH 包含
$HOME/go/bin和/usr/local/go/bin - Windows：检查系统环境变量中
GOROOT和PATH是否包含%GOROOT%\bin
安装官方 Go 扩展并禁用内置语言功能
VS Code 自带的 Go 语法高亮很基础，且与官方扩展冲突。必须卸载或禁用内置支持，只保留 golang.go 扩展（由 Go 团队维护）。
- 在扩展市场搜索
golang.go，安装后重启窗口 - 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Preferences: Configure Language Specific Settings...→ 选择Go→ 添加"editor.quickSuggestions": true等个性化设置 - 在设置中搜索
go.gopath，若使用 Go 1.16+，无需设置；若仍需指定，填绝对路径如/home/you/go，不要用~
配置 settings.json 关键项避免常见故障
默认配置下，VS Code 可能用错模块代理、无法识别 go.work、或格式化失败。这些都源于 settings.json 缺少显式声明。
-
"go.toolsManagement.autoUpdate": true—— 自动更新gopls、dlv等工具，避免版本不兼容 -
"go.formatTool": "goimports"—— 比默认gofmt更智能，自动增删 import -
"go.useLanguageServer": true—— 强制启用gopls，这是所有智能提示的基础 -
"go.goplsEnv": {"GOWORK": "off"}—— 若项目不用go.work，关掉它可避免工作区解析错误
真正卡住人的往往不是“怎么装”，而是 gopls 启动失败时 VS Code 不报具体错误，只显示 “Loading…”。这时候得看 Output 面板里 gopls 的日志，再对照 go env 输出检查 GOPROXY 和 GO111MODULE 是否合理。
