VSCode运行Go项目需确保go version≥1.21、GOPROXY生效、GOBIN可写且在PATH中、项目在module根目录打开；否则gopls无法启动、dlv找不到、跳转失效、断点不命中。
VSCode 要真正跑起 Go 项目，不是装个插件就完事——gopls 启不起来、dlv 找不到、跳转失效、断点不命中，八成是环境链断在了 GOPROXY、GOBIN 或模块根目录这三处。
go version 和 GOPROXY 必须先验证好
VSCode 的 Go 插件启动时会调用系统 go 命令。如果 go version 报错或低于 1.21，gopls 可能压根不加载；而所有工具下载失败（尤其是 dlv、gopls）的头号原因，是 GOPROXY 没生效。
- 打开终端，运行
go version，确认输出类似go version go1.22.5 darwin/arm64；若报command not found，请先配置GOROOT和PATH - 运行
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐），再执行go env GOPROXY确认已写入 - 别信“
GO111MODULE=on就万事大吉”——它只影响模块行为，不解决代理问题
gopls 不显示 running？检查 GOBIN 是否可写且在 PATH 中
gopls 是 VSCode Go 支持的核心语言服务器，它默认安装到 $GOBIN。如果该路径不存在、不可写，或没加入 PATH，VSCode 就会反复崩溃或卡在 “Loading…”。
- 运行
go env GOBIN，若为空，手动设为$GOPATH/bin：go env -w GOBIN=$GOPATH/bin（macOS/Linux）或go env -w GOBIN=%USERPROFILE%\go\bin（Windows） - 确认
$GOBIN已加入系统PATH：重启终端后执行echo $PATH（或path）看是否包含该路径 - 手动触发安装：
go install golang.org/x/tools/gopls@latest，然后重启 VSCode
按 F5 调试失败：Failed to launch: could not find Delve
VSCode 默认用 dlv 调试，但它不会自动把 dlv 加入 PATH，也不会帮你建 .vscode/launch.json。报这个错，说明路径没打通，或者配置没对上。
立即学习“go语言免费学习笔记（深入）”；
- 先装
dlv：go install github.com/go-delve/delve/cmd/dlv@latest，完成后检查$GOBIN/dlv是否存在 - 在项目根目录（即含
go.mod的目录）下创建.vscode/launch.json，内容至少包含：
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch",
"type": "go",
"request": "launch",
"mode": "exec",
"program": "${workspaceFolder}/main.go"
}
]
}
-
"mode": "exec"用于普通main.go；若调试测试，改用"mode": "test"并确保当前文件有func TestXxx
真正卡住人的，往往不是“怎么配”，而是 VSCode 拿到的环境和你在终端里用的不是同一套
macOS/Linux 下双击图标启动 VSCode，它通常不加载 ~/.zshrc；Windows GUI 启动也不继承用户环境变量。结果就是你在终端里 which go 有输出，VSCode 终端里却是空的。
- macOS/Linux：从终端执行
code .启动 VSCode，而不是双击图标 - Windows：确认系统环境变量
PATH包含%USERPROFILE%\go\bin和 Go 安装目录下的\bin（如C:\Program Files\Go\bin） - 验证方式：在 VSCode 内置终端（
Ctrl+`）中运行go env GOPROXY和which dlv，输出必须和终端一致
