根本原因是$path未包含go二进制目录；linux/macos需将/usr/local/go/bin添加至~/.zshrc或~/.bash_profile并source，windows需手动添加c:\go\bin到系统path环境变量。
Go 二进制安装后为什么 go version 报 command not found？
根本原因不是 Go 没装好，而是 $PATH 没更新。Linux/macOS 下手动解压 go 到 /usr/local/go 后，必须把 /usr/local/go/bin 加进 shell 配置文件（如 ~/.zshrc 或 ~/.bashrc）。
常见错误操作：只改了当前终端的 PATH（比如临时执行 export PATH=$PATH:/usr/local/go/bin），关掉终端就失效；或者改错了配置文件（比如在 .bash_profile 里加了，但你用的是 zsh）。
- 确认 shell 类型：运行
echo $SHELL - 编辑对应配置文件：
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.zshrc - 重载配置：
source ~/.zshrc - 验证：
which go应输出/usr/local/go/bin/go
用 gvm 管理多版本 Go 时，gvm use 不生效？
gvm 是社区维护的 Go 版本管理器，但它依赖 shell 函数注入。如果安装后 gvm 命令能用，但 gvm use 没反应或提示 command not found: go，大概率是初始化脚本没加载。
gvm 安装完会提示你把一段 source 命令加进 shell 配置文件——很多人复制漏了、或加到了错误位置（比如加在注释块里），导致函数未定义。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 检查是否已 source：
type gvm应返回gvm is a shell function - 若失败，手动执行安装提示里的完整
source行（通常形如source $HOME/.gvm/scripts/gvm） - 再运行
gvm list看是否有已安装版本；没有就先gvm install go1.22 -
gvm use go1.22后，go version必须立刻反映变更
VS Code + Go 扩展调试时提示 “Failed to find ‘dlv’”？
Go 扩展默认依赖 dlv（Delve）调试器，但它不会自动安装。即使 go 命令可用，dlv 缺失会导致断点不命中、启动失败等“静默故障”。
别用 brew install delve 或系统包管理器装——版本可能不匹配、路径不在 $PATH，且 Go 扩展偏好从 GOBIN 或 $GOPATH/bin 查找。
- 先确认
GOBIN设置：go env GOBIN；若为空，建议设为$HOME/go/bin - 运行：
go install github.com/go-delve/delve/cmd/dlv@latest - 重启 VS Code（仅重载窗口不够，扩展需完全重启）
- 调试前检查状态栏右下角是否显示 “Delve (running)”
为什么 go mod init 后 go run main.go 仍报 import 错误？
这是模块路径与实际导入路径不一致导致的典型问题。比如项目根目录是 ~/myapp，你执行 go mod init myapp，但代码里写了 import "github.com/xxx/myapp/utils" ——Go 会严格按 go.mod 第一行的 module path 解析本地 import。
新手常误以为 go mod init 只是“起个名”，其实它定义了整个模块的导入根路径，所有相对导入都以此为基准。
- 检查
go.mod文件首行：module xxx是否与代码中所有import语句前缀一致 - 本地包导入必须用模块名开头，不能用
./或../（Go 不支持） - 改 module path 后，所有内部 import 都要同步调整，否则编译失败
- 用
go list -m和go list -f '{{.Dir}}' .辅助确认当前模块解析路径
go、dlv、编辑器、shell 配置、模块路径，任意一环的路径错位都会导致“看起来装好了，实际跑不通”。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
