go version报“command not found”说明PATH未正确配置Go的bin路径；需确认GOROOT指向真实安装目录，将$GOROOT/bin（Linux/macOS）或%GOROOT%\bin（Windows）加入PATH，Windows需重启终端、macOS/Linux需source配置文件。
go version 命令没反应，说明环境变量根本没生效
执行 go version 报错 “command not found” 或直接无输出，不是 Go 没装好，而是 PATH 里压根没加 Go 的可执行路径。常见原因是：安装时勾选了“Add to PATH”但系统没刷新（尤其 Windows），或手动配置时写错了路径（比如把 $GOROOT/bin 写成 $GOROOT）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先确认
GOROOT是否指向真实安装目录（Linux/macOS 通常为/usr/local/go，Windows 多为C:\Go）；用ls -l $GOROOT/bin或dir %GOROOT%\bin看是否存在go可执行文件 - PATH 中必须显式包含
$GOROOT/bin（Unix-like）或%GOROOT%\bin（Windows），不能只加$GOROOT - Windows 用户改完环境变量后，务必新开一个 cmd/PowerShell；macOS/Linux 改完
~/.zshrc或~/.bash_profile后要source，否则当前终端不生效
GOBIN 和 GOPATH 在 Go 1.16+ 几乎不用手动设
从 Go 1.16 开始，go mod 默认启用，模块模式成为事实标准。此时 GOPATH 仅影响 go install 安装的二进制位置，而 GOBIN 更是完全被 GOBIN 环境变量取代——除非你明确想把 go install 的结果放到非默认位置（如 ~/bin），否则不必碰它。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不设
GOPATH也能正常开发：go run、go build、go test全部基于模块路径，和GOPATH无关 - 如果要用
go install安装命令行工具（比如dlv），确保$GOBIN在 PATH 里；没设GOBIN时，默认装到$GOPATH/bin，而$GOPATH默认是$HOME/go - VS Code 的 Go 扩展会自动识别模块根目录，不需要靠
GOPATH定位项目
vscode 装了 Go 插件却无法跳转定义，大概率是 dlv 或 gopls 没装全
VS Code 中 Ctrl+Click 无法跳转函数定义、没有智能提示、调试按钮灰掉——这不是插件问题，而是底层语言服务器或调试器缺失。官方 Go 插件依赖 gopls（语言服务器）和 dlv（调试器），两者都需单独安装。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在终端运行
go install golang.org/x/tools/gopls@latest和go install github.com/go-delve/delve/cmd/dlv@latest，确保二者都成功安装到$GOBIN - 安装后重启 VS Code，看右下角是否显示 “gopls (running)”；若仍报错，打开命令面板（Ctrl+Shift+P），搜 “Go: Install/Update Tools”，勾选全部工具重装
- 检查
gopls日志：Cmd+Shift+P → “Developer: Toggle Developer Tools” → Console 标签页，过滤 “gopls”，常见错误如 “no module found” 说明当前打开的文件不在模块根目录下
go mod init 后 go.sum 文件为空，不是 bug 是预期行为
新建项目执行 go mod init example.com/foo 后，go.sum 为空、go.mod 只有一行 module example.com/foo，这是完全正常的。Go 不会在初始化时预填充校验和，只有当首次 go get 或 go build 引入外部依赖时，才会生成 go.sum 并记录 checksum。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 别手动编辑
go.sum，它由 Go 工具链自动生成和维护 - 如果后续
go build报 “checksum mismatch”，说明依赖被篡改或缓存损坏，运行go clean -modcache清理再试 - CI/CD 流程中应提交
go.sum，它能防止依赖被恶意替换，但本地开发初期为空无需担心
