go version和go env验证失败说明PATH未包含Go二进制路径：macOS/Linux需确认/usr/local/go/bin在PATH中并source ~/.zshrc，Windows需检查%GOROOT%\bin是否加入系统环境变量且重启终端。
go version 和 go env 验证失败，说明环境变量没配对
安装完 Go 二进制包后，go version 报“command not found”或 go env GOPATH 输出空值，基本是 PATH 没包含 /usr/local/go/bin（macOS/Linux）或 %GOROOT%\bin（Windows）。GOROOT 不强制设，但设了就必须指向真实安装路径；GOPATH 在模块模式下已非必需，但若设了，就别让它和项目目录重叠——否则 go mod init 可能误读为子模块。
常见错误操作：
- 只改了
~/.bashrc却在 zsh 终端里测试，忘了source ~/.zshrc - Windows 用户把
GOROOT设成C:\Go，但实际装在C:\Program Files\Go，路径带空格又没加引号 - Linux/macOS 解压时没用
sudo，导致/usr/local/go权限不足，go命令无法执行
go mod init 后 go build 报 “no Go files in current directory”
这说明当前目录下没有合法的 .go 文件，或者有但没声明 package main。模块初始化只是生成 go.mod，不等于项目就“活”了。
必须手动创建至少一个文件（比如 main.go），内容严格满足：
立即学习“go语言免费学习笔记（深入）”；
- 首行是
package main（不能拼错，不能有空格） - 包含且仅包含一个
func main()函数（函数体可空，但括号不能少） - 文件名无所谓，但不能是
main_test.go或其他被 Go 忽略的命名模式
示例最小可行文件：
package main
func main() {
}
import 包后 go mod tidy 卡住或报错 “unknown revision”
本质是模块代理或网络问题。go mod tidy 默认走 https://proxy.golang.org，国内直连常超时或返回 403。不是代码写错了，是请求根本没发出去。
解决方式优先级从高到低：
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐） - 确认没设错
GOPRIVATE：如果误加了github.com/*这类通配，会强制绕过代理直连，导致失败 - 删掉
go.sum再试一次go mod tidy——旧校验和可能和新版本冲突 - 临时关防火墙或杀毒软件，某些 Windows 安全软件会拦截
go进程的 HTTPS 请求
go run main.go 成功，但 go list -m all 显示一堆 indirect 依赖
这不算错误，而是模块解析正常的副作用。indirect 表示该依赖不是你直接 import 的，而是被某个一级依赖拉进来的。只要没报错、go build 能过，就不用管。
真正要警惕的是：
-
go list -m all输出里出现(replaced)字样——说明有依赖被本地路径或特定 commit 替换了，上线前必须确认是否故意为之 - 同一依赖出现多个版本（如
golang.org/x/net v0.17.0和v0.20.0并存），可能引发运行时行为不一致 -
go.mod里require块中存在未使用的包——go mod tidy应该自动清理，如果没清，说明代码里还有隐式引用（比如通过反射或构建标签）
模块树的干净程度，比单次 go run 成功重要得多。很多人卡在“能跑就行”，结果换机器或 CI 就崩，根源就在 go list -m all 没验证过。
