vscode中go命令报“command not found”是因为其未继承系统shell环境变量，尤其macos/linux从图标启动时不会加载~/.zshrc等配置；需通过终端执行code .启动、验证which go输出，并确保path包含go的bin目录。
go 命令在 VSCode 里报 command not found，不是插件没装好，而是 VSCode 根本没找到你系统里的 go 可执行文件——它不继承 shell 的环境变量，尤其 macOS/Linux 下从图标启动时最常出这问题。
VSCode 找不到 go 命令？先确认 PATH 是否真正生效
VSCode 启动方式决定它读哪套环境变量。桌面图标、Spotlight、开始菜单启动的 VSCode，通常完全忽略 ~/.zshrc 或 ~/.bash_profile 里的 PATH 设置。
- macOS/Linux：在终端里运行
code .打开项目，确保终端已执行过source ~/.zshrc（或对应配置文件） - Windows：检查系统级环境变量（不只是用户级），
Go\bin目录必须出现在“系统变量”→Path中 - 验证方式：在 VSCode 集成终端中运行
which go（macOS/Linux）或where go（Windows），有输出才算真正生效 - 常见坑：Homebrew 安装的 Go 路径是
/opt/homebrew/bin/go（Apple Silicon）或/usr/local/bin/go（Intel），别只写进用户 profile 却忘了 source
gopls 不工作？别手动改路径，让插件自己装
VSCode Go 插件默认会尝试自动下载 gopls，但如果你提前手动装过旧版、或 GOBIN 指向了奇怪目录，反而会导致冲突或静默失败。
- 删掉旧的
gopls：运行go install golang.org/x/tools/gopls@latest前，先执行rm $(go env GOPATH)/bin/gopls - 禁用自定义路径：在 VSCode 设置里清空
go.gopls.path，让插件走默认逻辑 - 强制重装语言服务器：命令面板输入
Go: Install/Update Tools，只勾选gopls，点确定 - 关键判断：打开
.go文件后，看右下角状态栏是否显示gopls (running)，没显示就说明没起来
dlv 调试失败报 could not launch process？路径和权限都得对
这个错误 90% 是因为 VSCode 找不到 dlv，或者找到了却没执行权限，不是代码或 launch.json 的问题。
- 安装必须用
@latest：运行go install github.com/go-delve/delve/cmd/dlv@latest，别省略@latest，否则可能装到不兼容的老版本 - 路径必须是绝对路径：在 VSCode 设置里搜
go.delvePath，填入完整路径，例如/Users/xxx/go/bin/dlv，不能写~/go/bin/dlv - Linux/macOS 权限检查：运行
ls -l $(go env GOPATH)/bin/dlv，确保有x（可执行）权限，没有就补一句chmod +x $(go env GOPATH)/bin/dlv - 调试前必须在模块根目录：VSCode 当前打开的文件夹必须包含
go.mod，否则dlv启动时找不到构建上下文
插件该选 Go 还是 Go Nightly？看你的 go.work 和 Go 版本
稳定版 Go 插件（非 Nightly）对 Go 1.21 及更早版本足够用；但如果你用的是 Go 1.22+，且项目用了 go.work 多模块工作区，Nightly 是唯一能正确识别和调试的选项。
- Go 1.22+ +
go.work→ 必须用Go Nightly，否则gopls无法索引跨模块符号 - 团队协作项目 → 优先用稳定版
Go，避免预发布版行为差异引发同事间配置不一致 - 装完 Nightly 后必须重启 VSCode：插件不会热加载，不重启等于白装
- 验证是否生效：打开一个含多个
go.mod的子模块，在main.go里 Ctrl+Click 跳转函数定义，能跨模块跳过去才算成功
dlv 权限没设、gopls 被旧版本残留干扰——这些地方不显眼，但一错就全盘失效。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
