go version 报错说明 Go 二进制未加入 PATH，而非未安装；需确认 PATH 是否包含 Go 的 bin 目录（如 C:\Go\bin 或 /usr/local/go/bin），并确保 shell 配置已重载（如 source ~/.zshrc），不同终端环境（PowerShell/WSL/IDE）需分别配置。
go version 命令报错或无输出
说明 Go 二进制文件没进 PATH，不是“没装好”，而是 shell 找不到 go 可执行文件。
常见现象：command not found: go 或直接无响应；go version 在 PowerShell 正常，但在 WSL 或终端里失效——本质是不同 shell 加载了不同配置文件。
- Windows 用户：检查系统环境变量
PATH是否包含C:\Go\bin（或你安装路径下的bin目录），别只改用户变量，系统变量也要加 - macOS/Linux 用户：确认
~/.zshrc（或~/.bash_profile）里写了export PATH=$PATH:/usr/local/go/bin，然后运行source ~/.zshrc - WSL 用户：别复用 Windows 的 PATH，要在 WSL 里单独配置；
which go返回空就说明没生效
GOPATH 设置后 go env 仍显示默认路径
go env GOPATH 输出不是你设的值？不是配置失败，而是 Go 1.16+ 默认启用 GO111MODULE=on，且不再强制依赖 GOPATH/src 存放代码——但部分老工具（如 go get 旧用法、某些 IDE 插件）仍会查它。
真正影响的是：你手动写的 import "github.com/user/repo" 能否被解析、go install 生成的二进制是否落到 $GOPATH/bin。
立即学习“go语言免费学习笔记（深入）”；
- 验证方式：运行
go env GOPATH和echo $GOPATH对比，若不一致，说明 shell 环境变量没刷新，或用了不同 shell 启动终端 - 推荐做法：只设一次
GOPATH，比如export GOPATH=$HOME/go，再建mkdir -p $GOPATH/{src,bin,pkg}，不用纠结“必须放 src 下” - 注意：Go Modules 模式下，项目根目录有
go.mod就不看GOPATH/src，但$GOPATH/bin仍是go install默认输出位置
go mod init 初始化失败：module path 不合法
运行 go mod init example.com/myapp 报错 malformed module path "example.com/myapp": missing dot in first path element？这不是网络问题，是模块路径语法校验失败。
Go 要求模块路径至少含一个点（.），且不能以数字开头、不能含大写字母、不能是纯域名（如 example 不行，example.com 可以）。
- 安全写法：用真实域名反写，如公司域名为
acme.com→com.acme.project；或用 GitHub 地址，如github.com/username/project - 本地开发临时用：可写
example.com/hello，只要带点、合法即可，不需真实存在该域名 - 错误示范：
myproject、MyProject、123app、hello-world（连字符不允许）
GOROOT 和 GOPATH 容易混淆的两个关键点
GOROOT 是 Go 自身安装位置，GOPATH 是你写代码、装依赖、放二进制的地方——它们不该一样，也不能互相替代。
典型误配：GOROOT 设成 $HOME/go（其实是 GOPATH 位置），结果 go build 找不到标准库；或把项目直接扔进 $GOROOT/src，下次升级 Go 就全丢了。
-
GOROOT通常由安装程序自动设好（Windows msi / macOS pkg），手动设置仅在多版本共存时需要，值应为/usr/local/go（Linux/macOS）或C:\Go（Windows） -
GOPATH推荐设为$HOME/go，不要嵌套在GOROOT内；$GOPATH/src只是历史习惯路径，现在多数人直接在任意目录go mod init，不再放这里 - IDE（如 Goland）里填
GOROOT是为了找编译器和 stdlib，填GOPATH是为了定位go install输出和旧式包查找逻辑，两者都得对，但作用完全不同
go version 有输出 → mkdir ~/myapp && cd ~/myapp → go mod init example.com/myapp → 写 main.go → go run . 打印 hello。中间任何一步卡住，基本就落在上面四个点里的某一个。最常被跳过的是 shell 配置重载和模块路径带点——这两处不修正，后面所有依赖、构建、IDE 集成都走不通。 
