VS Code 的 Go 开发需手动安装工具链与官方扩展，并正确配置 GOPATH、GOROOT 和 PATH；必须用 go mod init 初始化模块，且通过终端 code . 启动项目以确保环境变量生效。
VS Code 本身不自带 Go 支持，必须手动安装 Go 工具链 + VS Code 官方 Go 扩展，并正确配置 GOPATH、GOROOT 和 PATH —— 缺一不可，否则 go 命令能运行，但 VS Code 里代码提示、跳转、格式化全失效。
确认本地已安装 Go 并可命令行使用
VS Code 的 Go 扩展依赖系统级 go 可执行文件，不是“装了扩展就完事”。先在终端运行：
go version<br>go env GOPATH GOROOT
确保输出正常（如 go version go1.22.3 darwin/arm64），且 GOROOT 指向 Go 安装目录（如 /usr/local/go），GOPATH 是你存放 Go 项目的根路径（默认 $HOME/go）。常见错误：
-
command not found: go→ 未将go加入PATH（macOS/Linux 检查~/.zshrc或~/.bash_profile；Windows 检查系统环境变量） -
GOPATH被设为.或空 → 导致模块初始化失败、go mod报错 - 用 Homebrew/macOS 安装的 Go，
GOROOT可能是/opt/homebrew/Cellar/go/1.22.3/libexec，别硬写成/usr/local/go
安装并配置 VS Code 的官方 Go 扩展
在 VS Code 扩展市场搜 Go，认准作者是 Go Team at Google（ID：golang.go）。安装后它会自动提示下载配套工具（gopls、dlv、goimports 等）。关键点：
立即学习“go语言免费学习笔记（深入）”；
- 首次打开 Go 文件时，右下角弹出 “Installing tools…” 是正常行为，但若卡住或报错（如
failed to install gopls），说明网络问题或代理没配好 —— 需提前设置GO111MODULE=on和GOPROXY=https://goproxy.cn,direct - 不要手动用
go install golang.org/x/tools/gopls@latest安装gopls：VS Code 扩展有自己的工具缓存路径，混用易冲突 - 扩展设置里禁用
"go.useLanguageServer": false—— 关闭 LSP 会让所有智能提示退化为纯正则匹配，基本不可用
项目初始化必须用 go mod init，且工作区要打开到模块根目录
VS Code 的 Go 支持高度依赖 Go Modules。如果只是新建一个 main.go 就直接打开，gopls 会因找不到 go.mod 而降级为“无模块模式”，导致：
- 第三方包无法跳转、无补全
-
go test按钮灰色不可点 - 保存时格式化失效（
gofmt不生效）
正确做法：
mkdir myapp && cd myapp<br>go mod init myapp<br>code . # 在当前目录（含 go.mod）启动 VS Code
注意：VS Code 左下角状态栏应显示 Go (GOPATH) 或 Go (Module)，后者才是预期状态。
调试前必须检查 dlv 版本与 Go 版本兼容性
dlv（Delve）是 VS Code 调试 Go 的底层调试器。Go 1.21+ 默认启用 goversion 检查，若 dlv 太旧（如 v1.20.x），启动调试会报错：
FATAL error initializing debugger: unknown flag: --api-version
解决方法只有升级 dlv：
go install github.com/go-delve/delve/cmd/dlv@latest
然后在 VS Code 设置中确认：
-
"go.delvePath"指向新安装的dlv（通常在$GOPATH/bin/dlv） -
"debug.allowEmtpyWorkspace"设为false（避免在无go.mod目录误启调试）
调试配置（.vscode/launch.json）里 "mode": "auto" 即可，不用硬写 exec 或 test —— gopls 会根据当前文件自动判断。
最常被忽略的是：VS Code 启动时读取的是用户 Shell 的环境变量，不是 GUI 应用继承的环境。Mac 上从 Dock 启动 VS Code，PATH 可能不含 go；Windows 上用快捷方式启动，可能没加载系统变量。务必用终端执行 code . 打开项目，才能保证环境一致。
