vscode运行go项目需确保go version≥1.21、goproxy生效、gobin可写且在path中、项目在module根目录打开，并正确配置launch.json；否则gopls无法启动、dlv找不到、跳转失效、断点不命中。
VSCode 要真正跑起 Go 项目，不是装个插件就完事——gopls 启不起来、dlv 找不到、跳转失效、断点不命中，八成是环境链断在了 GOPROXY、GOBIN 或模块根目录这三处。
go version 和 GOPROXY 必须先验证好
VSCode 的 Go 插件（golang.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？检查 GOPATH 和 GOBIN 是否可写
gopls 是 VSCode Go 支持的核心语言服务器，它默认安装到 $GOPATH/bin。如果该路径不存在、不可写，或没加入 PATH，VSCode 就会反复崩溃或卡在 “Loading…”。
- 运行
go env GOPATH，记下路径（如/Users/you/go），确保该目录存在且当前用户有读写权限 - 运行
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。报这个错，说明路径没打通，或者配置没对上。
- 先装
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",
"env": {}
}
]
}
go.mod），否则 gopls 无法识别包结构，调试器也拿不到正确构建上下文mode: "test" 调试 main 函数——它只跑测试，不启动程序跳转定义/补全失效？大概率没在 module 根目录打开项目
VSCode Go 插件严重依赖 gopls 对模块路径的解析。如果你直接打开某个 .go 文件（而非整个 module 文件夹），gopls 会降级为“单文件模式”，跳转、补全、引用搜索全部失灵。
- 关闭当前窗口，用 VSCode 的 File → Open Folder…，选择包含
go.mod的最外层目录 - 右下角状态栏应显示
gopls (running)，鼠标悬停在fmt.Println上能看到文档；若显示Go (no workspace)，说明没识别到 module - 如果已有
go.mod但依然失效，尝试在终端进该目录后运行go mod tidy，再重载窗口（Ctrl+Shift+P→Developer: Reload Window）
最容易被忽略的是：VSCode 的 Go 支持不是“开箱即用”，而是“开箱即配”——它不管理你的 go 安装，也不替你决定 GOBIN 权限和 launch.json 的 mode 值。每个环节断掉，表现都差不多：看起来装好了，但啥都不动。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
