VS Code需安装官方Go扩展并配置本地Go工具链才能正常工作；必须确保go命令在PATH中、禁用旧插件、设置gopls启用模块模式、调试使用dlv且program为相对路径。
VS Code 本身不自带 Go 支持，必须通过 Go 扩展（由 Go 团队维护）配合本地已安装的 Go 工具链才能正常工作。没装 go 命令、或扩展未正确识别 GOPATH/GOBIN，所有功能（跳转、补全、格式化）都会失效。
确认本地 Go 工具链已正确安装并可被 VS Code 读取
VS Code 的 Go 扩展依赖系统 PATH 中的 go 可执行文件。它不会自己下载 Go，也不会读取你手动设置的环境变量（除非你在 VS Code 启动方式中显式加载 shell 配置）。
- 终端中运行
which go（macOS/Linux）或where go（Windows），确保输出有效路径 - 在 VS Code 终端（
Ctrl+`）中运行go version，必须成功返回版本号；若报command not found，说明 VS Code 没继承到你的 shell 环境 - Mac 用户常见问题：从 Dock 或 Spotlight 启动 VS Code 时，不会加载
~/.zshrc或~/.bash_profile；改用终端命令code启动可解决 - Windows 用户注意：不要混用 Git Bash 和 PowerShell 的
go安装；统一使用官方 MSI 安装包，并勾选「Add Go to PATH」
安装并启用官方 Go 扩展（不是 “Go for Visual Studio Code” 等旧名插件）
VS Code 商店中唯一推荐的 Go 扩展是 ID 为 golang.go 的那个，作者是 Go Team at Google。其他名称相似的插件大多已废弃或功能不全。
- 在扩展面板搜索
Go，认准图标为蓝色 G 字母 + 白色背景，发布者为Go Team at Google - 禁用任何标有
Deprecated或更新时间早于 2022 年的 Go 相关插件 - 安装后重启 VS Code，打开一个
.go文件，状态栏右下角应显示 Go 版本号（如go1.22.3）和当前 GOPROXY - 首次打开 Go 文件时，扩展会自动提示安装依赖工具（
gopls、dlv、goimports等）；点击Install All，不要跳过
配置 settings.json 关键项以适配现代 Go 工作流（Go Modules）
Go 1.16+ 默认启用模块模式（Modules），但 VS Code 的 Go 扩展仍默认尝试兼容老式 GOPATH 工作区。不调整配置会导致 gopls 报错、无法识别依赖、跳转失败。
立即学习“go语言免费学习笔记（深入）”；
{
"go.useLanguageServer": true,
"go.toolsManagement.autoUpdate": true,
"go.gopath": "",
"go.goroot": "",
"go.toolsEnvVars": {
"GOPROXY": "https://proxy.golang.org,direct"
},
"go.formatTool": "goimports",
"go.lintTool": "golangci-lint",
"gopls": {
"build.experimentalWorkspaceModule": true,
"analyses": {
"fillreturns": true,
"nonewvars": true
}
}
}
-
"go.gopath"和"go.goroot"必须设为空字符串（""），否则扩展会强行进入 GOPATH 模式 -
"gopls"下的"build.experimentalWorkspaceModule"是关键开关，开启后gopls才能正确解析go.mod和多模块项目 -
"go.formatTool"设为goimports可同时处理格式化与 import 排序；需确保该工具已安装（扩展通常会自动装） - 若项目使用私有模块，需在
"go.toolsEnvVars"中覆盖GOPROXY，例如："https://goproxy.cn,direct"
调试配置：launch.json 中 mode 和 program 的典型写法
VS Code 调试 Go 程序依赖 delve（dlv），但配置错误会导致启动失败、断点不命中或报 could not launch process: fork/exec ... no such file or directory。
- 调试单个文件（如
main.go）时，"program"必须写相对路径（相对于工作区根目录），不能写绝对路径或./main.go - 推荐使用
"mode": "auto"，它会自动识别是exec（可执行文件）、test（测试）还是exec（命令行程序） - 避免手动指定
"env"覆盖GOPATH或GOROOT，这会干扰dlv自身的环境判断 - 若调试时报错
dlv not found，检查是否在终端运行过go install github.com/go-delve/delve/cmd/dlv@latest，且dlv在 PATH 中
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Package",
"type": "go",
"request": "launch",
"mode": "auto",
"program": "${workspaceFolder}/cmd/myapp/main.go"
}
]
}
最常被忽略的是：VS Code 的 Go 扩展对多模块项目（如含多个 go.mod 的 monorepo）支持仍较脆弱，gopls 可能只识别根目录的模块。此时需手动在每个子模块目录下打开 VS Code，或使用 "gopls": { "build.directoryFilters": ["-vendor", "-internal"] } 等过滤策略干预扫描范围。
