go 1.21+已无需配置gopath，验证安装需三步：go env goproxy应设为https://goproxy.cn，goroot指向安装目录，gopath为空属正常；go mod init报错主因是模块路径不规范或不在根目录；go test失败多因_test.go命名或testxxx函数签名不符。
Go 1.21+ 版本在主流系统上已无需额外配置 GOPATH，直接安装即可写代码、跑测试，但新手常卡在 go mod init 报错或 go test 找不到包——根本原因不是环境没装好，而是模块初始化和工作区路径没对齐。
怎么确认 Go 真正装好了？别只信 go version
运行 go version 成功只说明二进制存在，不代表开发链路通。必须验证三件事：
-
go env GOPROXY应返回类似https://proxy.golang.org,direct（国内建议设为https://goproxy.cn） -
go env GOROOT指向你安装的 Go 目录（如/usr/local/go），不是用户目录 -
go env GOPATH在 Go 1.13+ 默认为空，这是正常现象；若非空，反而可能干扰模块行为
如果 go env 输出里 GOPROXY 是空或 direct 单独出现，go get 很可能超时失败——立刻执行：go env -w GOPROXY=https://goproxy.cn
go mod init 总报 “unknown revision” 或 “no required module provides package” 怎么办
这不是网络问题，是当前目录不在模块根下，或模块名与实际路径冲突。常见场景：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 你在
~/projects/myapp下执行go mod init myapp，但项目实际要发布到 GitHub，应写成go mod init github.com/yourname/myapp - 目录名含大写字母或下划线（如
MyApp），而go mod init后续导入路径会变成小写，导致 import 不匹配 - 项目里已有
vendor/目录但没启用 vendor mode，go build会优先读 vendor 而非go.mod，先删掉或加-mod=mod参数
最稳做法：进空目录 → go mod init example.com/hello → 写 main.go → go run . 跑通再加其他依赖
go test 执行失败，提示 “cannot find package” 或 “no Go files in current directory”
Go 的测试文件必须满足两个硬条件：
- 文件名以
_test.go结尾（如math_test.go） - 测试函数必须是
func TestXxx(t *testing.T)形式，且首字母大写 - 如果测试文件和被测代码不在同一目录，
go test默认不跨目录扫描——要么 cd 进对应包目录执行，要么用go test ./...扫描子树
另外，go test -v 会显示实际运行了哪些测试函数；如果什么都没列出来，八成是文件名或函数签名不符合规范，不是逻辑写错了。
真正麻烦的不是装 Go，而是模块路径、工作区目录、导入路径三者没对齐。一个 go mod init 命令输错，后面所有 import 都得跟着改——动手前先想清楚这个路径将来会不会被别人 go get，比反复重装 Go 重要得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
