VSCode调试Go失败主因是go/dlv未被正确识别、go.mod缺失或launch.json中program路径错误；需确保VSCode终端能执行which go和dlv version，且program指向含main.go的准确路径。
VSCode 本身不运行 Go，它靠调用系统 go 命令和 dlv 调试器来执行、构建、调试代码；运行失败八成不是插件没装，而是 go 不在 VSCode 环境里、go.mod 没在打开的文件夹根目录、或 launch.json 的 program 路径写错了。
VSCode 终端里 which go 返回空？环境变量根本没加载进来
VSCode 图形界面启动时（比如双击图标），不会自动读取你的 ~/.zshrc 或 ~/.bash_profile，所以即使终端里 go version 正常，VSCode 内置终端也可能找不到 go。
- macOS：从终端执行
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）
dlv 安装成功但调试时报 “dlv not found”？路径没进 PATH 或架构不匹配
go install github.com/go-delve/delve/cmd/dlv@latest 生成的二进制默认放在 $GOBIN/dlv，但 VSCode 不会自动把它加入 PATH；更隐蔽的问题是 macOS ARM64 或 WSL 下用 go install 编译的 dlv 可能因 CGO 或架构问题无法运行。
- 安装后立刻验证：
$(go env GOBIN)/dlv version，必须输出版本号，否则说明没装对 - 如果报
no such file or directory，大概率是动态链接库缺失（尤其 WSL），改用二进制安装：wget https://github.com/go-delve/delve/releases/download/v1.23.0/dlv_v1.23.0_linux_amd64.tar.gz解压后放$GOBIN - macOS ARM64 用户避免用
go install，直接下载dlv_v1.23.0_darwin_arm64.zip并解压到$GOBIN - 确保
go.toolsManagement.autoUpdate设为true，让扩展自动管理dlv版本，减少手动干预
最常被忽略的一点：VSCode 和你在终端里用的不是同一套环境。花 30 秒在 VSCode 终端里跑一遍 go env 和 dlv version，比反复重装插件、清配置、换设置高效得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
