go命令无法识别的根本原因是GOROOT未正确设置或PATH未包含$GOROOT/bin（Windows为%GOROOT%\bin）；需先验证GOROOT路径和PATH是否包含其bin目录，再根据shell类型修改对应配置文件并source生效。
go 命令无法识别？先确认 GOROOT 和 PATH
不是安装完 .msi 或 .pkg 就万事大吉——go 命令找不到，90% 是 GOROOT 没设对，或 PATH 里漏了 %GOROOT%\bin（Windows）或 $GOROOT/bin（macOS/Linux）。
验证方式很简单：
- Windows：在 CMD 中运行
echo %GOROOT%，应输出类似C:\Program Files\Go；再运行echo %PATH%，检查是否含C:\Program Files\Go\bin - macOS/Linux：运行
go env GOROOT看路径，再运行echo $PATH确认该路径下的bin目录已加入 - 如果
go version报 “command not found”，别急着重装，先改环境变量。Mac 用户尤其注意 shell 类型（zsh/bash），别往错误的配置文件（如~/.bashrc）里写export PATH
VSCode 装了 Go 插件却没反应？工具链没装全
VSCode 的 Go 扩展（golang.go）本身不带调试器和语言服务器，它会尝试自动下载 gopls（语言服务）、dlv（Delve 调试器）、gofumpt 等工具——但国内直连 GitHub 经常失败，状态栏卡在 “Installing tools…” 就是典型表现。
手动补救更可靠：
立即学习“go语言免费学习笔记（深入）”；
- 打开终端，逐个执行：
go install golang.org/x/tools/gopls@latest、go install github.com/go-delve/delve/cmd/dlv@latest - 装完后，在 VSCode 里按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入 “Go: Install/Update Tools”，勾选全部，点 OK —— 这次应该秒过 - 注意：不要用
go get，Go 1.21+ 已弃用，必须用go install+ 版本后缀（如@latest）
launch.json 配置错一个字段，断点就不起作用
VSCode 调试 Go 必须依赖 .vscode/launch.json，但默认不生成，且官方模板里 mode 字段容易配错。常见症状：点击行号设断点，灰掉了；F5 启动后直接跑完，不暂停。
最简可用配置只保留三项：
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug",
"type": "go",
"request": "launch",
"mode": "auto",
"program": "${workspaceFolder}"
}
]
}
关键点：
-
mode: "auto"是目前最稳的选择，不用猜exec还是test；旧教程写的debug模式已废弃 -
program指向项目根目录即可，VSCode 会自动找main.go；别写成./main.go或绝对路径 - 确保当前打开的是整个文件夹（File → Open Folder），不是单个
.go文件——否则${workspaceFolder}解析为空
为什么 GOPATH 现在可以不管？但 go mod init 不能跳
Go 1.16+ 默认启用 module 模式，GOPATH 不再影响代码构建逻辑，VSCode 设置里留空 go.gopath 反而是推荐做法。但新手常误以为“不用管模块”，结果 go run main.go 报错：no required module provides package ...。
根本原因：没初始化模块。
- 进项目目录，立刻执行：
go mod init example.com/myapp（模块名可任意，但别用main） - 执行后生成
go.mod文件，后续所有go run、go build才能正确解析导入路径 - 如果已有
go.mod但报依赖缺失，运行go mod tidy自动拉取并写入
模块初始化这一步，比配环境变量还容易被跳过，但它卡在编译前，错误信息又不够直白，是实际搭建中最常卡住的环节。
