VS Code 中 Go 环境跑不起来，主因是工具链缺失、gopls 未安装或 GOROOT/GOPATH 配置错误；需确保 go 命令全局可用、手动验证 PATH、必装 gopls、项目含合法 go.mod，再查终端输出与日志定位问题。

go 环境在 VS Code 中跑不起来，大概率不是插件没装，而是工具链没到位、gopls 没启动成功，或者 GOROOT/GOPATH 路径配置错位——尤其 Windows 用户常因路径含空格或中文直接卡死。

确认 go 命令全局可用是前提

VS Code 的 Go 扩展不会帮你装 go，它只调用系统 PATH 里的 go。如果终端里运行 go version 报“命令未找到”，VS Code 一定无法工作。

• Windows 安装 .msi 包后，务必重启终端（CMD/PowerShell/Terminal），否则 PATH 不生效
• macOS/Linux 用 Homebrew 或 tar.gz 安装的，检查 /usr/local/go/bin 是否已加进 ~/.zshrc 或 ~/.bash_profile
• 别信“安装完自动配环境变量”的说法——手动验证 echo $PATH | grep go（macOS/Linux）或 echo %PATH%（Windows）更可靠

Go 扩展安装后必须装 gopls

2026 年起，官方 Go 扩展已弃用 gocode、go-outline 等旧工具，全部依赖 gopls（Go Language Server）。它不装，补全、跳转、诊断全失效。

• 打开 VS Code，按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）
• 输入并执行 Go: Install/Update Tools
• 勾选 gopls —— 其他工具可选，但 gopls 必须勾上，且不能失败
• 若提示 failed to install gopls，多半是代理问题：先运行 go env -w GOPROXY=https://goproxy.cn,direct，再重试

launch.json 调试配置现在基本不用手写

新版 Go 扩展支持“一键调试”：只要项目根目录有 main.go，点编辑器右上角 ▶️ 图标就能直接运行；F5 启动调试也自动匹配 main 包，无需手动建 .vscode/launch.json。

VS Code Node

通过作为 OpenClaw 节点连接的 VS Code/Cursor IDE 操作代码，提供 40 多种命令，涵盖文件操作、语言智能、Git、测试等功能。

下载

• 只有需要自定义参数（比如传 flag、指定工作目录）时才需手动配置 launch.json
• 如果手写了 launch.json 却报 cannot find package，先删掉它，让扩展自动接管
• dlv（Delve）仍需单独安装：go install github.com/go-delve/delve/cmd/dlv@latest，否则断点无效

模块初始化比 GOPATH 更关键

你不需要把代码放到 $GOPATH/src 下——那是 2018 年前的老规矩。现在只要项目目录里有 go.mod，VS Code 就能正确定位依赖和包路径。

立即学习“go语言免费学习笔记（深入）”；

• 新建项目文件夹，打开终端 cd 进去，运行 go mod init example.com/hello
• 创建 main.go，写个最简 func main()，保存后看左下角状态栏是否显示 gopls (running)
• 如果状态栏一直卡在 gopls (starting...)，大概率是 go.mod 里 module 名非法（含大写字母、下划线、空格）或网络不通

真正卡住人的地方，往往不是“怎么装”，而是“装完没反应”——这时候别急着重装插件，先盯住终端输出、状态栏提示、gopls 日志（可通过 Go: Toggle Language Server Log 查看），比盲目复制粘贴命令有用得多。