vscode运行go程序依赖系统go命令，失败主因是环境链断点：go/dlv/gopls未进path、启动方式导致环境隔离、项目不在module根目录、launch.json program路径错误或gopls缓存/权限问题。
VSCode 本身不运行 Go 程序，它只是调用你系统里已安装的 go 命令；只要终端里 go run main.go 能成功，VSCode 就一定能跑——失败几乎全是环境链断点导致的，不是插件没装，而是 go、dlv 或 gopls 没进 PATH，或没被正确识别。
VSCode 终端里 which go 返回空？说明环境变量根本没加载进来
macOS/Linux 下双击图标启动 VSCode，它不会读你的 ~/.zshrc 或 ~/.bash_profile；Windows 图形界面启动也可能不继承系统 PATH。这不是插件问题，是启动方式导致的环境隔离。
- macOS/Linux：从终端执行
code .启动 VSCode，它会继承当前 shell 环境 - Windows：检查系统环境变量
PATH是否包含%USERPROFILE%\go\bin和C:\Program Files\Go\bin（路径以go env GOROOT输出为准） - Linux 桌面环境：确保
~/.profile被加载，或在/etc/environment中显式追加PATH - 验证方式：打开 VSCode 内置终端（
Ctrl+`），直接运行which go和go env GOPROXY，两个都必须有合理输出
go run main.go 成功，但按 F5 报 could not launch process: fork/exec : no such file or directory
这是 launch.json 配置错误的典型表现——VSCode 默认生成的模板把 program 设为 "${workspaceFolder}"，但它只适用于单文件项目；真实项目通常有 cmd/、internal/ 等子目录，必须指向具体 .go 文件。
- 确保当前打开的文件夹是含
go.mod的模块根目录（不是子目录，也不是父级 workspace） - 手动创建
.vscode/launch.json，program字段必须是.go文件路径，例如："${workspaceFolder}/cmd/myapp/main.go" - 不要写成目录路径、二进制名，也不能漏掉
.go后缀 - 如果程序依赖环境变量（如
CONFIG_PATH），在env字段中显式声明，别指望继承终端变量
gopls 卡在 initializing 或跳转失效？不是重装插件，是缓存和权限问题
gopls 是 Go 扩展的核心语言服务器，它默认安装到 $GOBIN，且需要可写权限；一旦缓存损坏或路径不可写，就会静默降级，表现为无提示、跳转到定义失败、格式化不生效。
- 先运行
go env GOBIN，若为空，执行go env -w GOBIN=$(go env GOPATH)/bin（macOS/Linux）或go env -w GOBIN=%USERPROFILE%\go\bin（Windows） - 确认该路径存在且当前用户有读写权限（
ls -ld $(go env GOBIN)） - 手动重装：
go install golang.org/x/tools/gopls@latest，完成后重启 VSCode - 仍卡住？删掉缓存目录：
$HOME/Library/Caches/gopls（macOS）、%LOCALAPPDATA%\gopls（Windows）、$XDG_CACHE_HOME/gopls（Linux），再重启
按 Ctrl+F5 没反应，或调试报 could not find Delve？dlv 没装对或路径不通
VSCode 的 Go 扩展默认用 dlv 调试，但它不会自动帮你把 dlv 加进 PATH，也不会替你建 .vscode/launch.json。报这个错，90% 是二进制没生成、路径没暴露、或架构不匹配。
- 先手动装：
go install github.com/go-delve/delve/cmd/dlv@latest - 装完立刻验证：
dlv version要能输出，且which dlv返回路径必须在你的$PATH里（通常是$GOBIN/dlv或$GOPATH/bin/dlv） - macOS ARM64 或 Windows WSL 下若报
fork/exec: no such file or directory，大概率是 CGO 构建失败，换用预编译二进制（去 Delve releases 下载） - 调试
cgo项目必须在launch.json的env里加{"CGO_ENABLED": "1"}，否则符号加载失败，断点全部失效
最常被忽略的是：VSCode 不会自动继承你 shell 的环境变量，哪怕你在终端里 go version 正常，内置终端也可能找不到 go；另一个隐形坑是 go.mod 必须在打开的文件夹根目录，否则 gopls 和 dlv 都会静默降级或拒绝工作。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
