go version报“command not found”说明go二进制未加入path，需确认goroot路径正确（如/usr/local/go或c:go），将$goroot/bin添加至path，linux/macos执行source ~/.zshrc（或~/.bashrc），windows需重启终端并验证。
go version 命令报“command not found”或“不是内部或外部命令”
说明 go 二进制文件没进 PATH，最常见于手动解压安装（非 .msi/.pkg 图形化安装）后遗漏配置。Windows 用户尤其容易在系统变量和用户变量之间混淆，Linux/macOS 则常因 shell 配置文件（.bashrc、.zshrc）未生效或写错路径导致。
实操建议：
- 确认
GOROOT指向实际解压/安装目录（如/usr/local/go或C:Go），不能是子目录（如C:Goin） - Linux/macOS：在
.zshrc或.bashrc末尾添加两行（注意等号两侧**无空格**）：export GOROOT=/usr/local/go<br>export PATH=$PATH:$GOROOT/bin
- Windows：在“系统属性 → 高级 → 环境变量”中，向**系统变量**的
PATH追加%GOROOT%in（不要用%GOROOT%\bin或%GOROOT%/bin） - 改完必须重启终端（或运行
source ~/.zshrc/ 重新打开 CMD）
go env 显示 GOPATH 为空或指向意外路径
Go 1.16+ 默认启用 module 模式，GOPATH 不再强制用于项目存放，但部分工具（如旧版 go get 安装的命令）仍依赖 $GOPATH/bin。若 go env GOPATH 输出空或 /root/go（Linux）等非预期值，说明未显式设置。
实操建议：
- 明确是否需要传统
GOPATH工作区：纯 module 项目可跳过；若需go install工具（如gopls、dlv），则必须设GOPATH - Linux/macOS：在 shell 配置文件中追加
export GOPATH=$HOME/go<br>export PATH=$PATH:$GOPATH/bin
- Windows：新增系统变量
GOPATH，值为C:UsersYourNamego（**不要用中文路径或空格**），再将%GOPATH%in加入PATH - 验证：运行
go env GOPATH和echo $PATH | grep go（Linux/macOS）或echo %PATH%（Windows），确认路径存在且拼写一致
go run main.go 报错 “cannot find package” 或模块初始化失败
这是 module 模式未就绪的典型表现，常见于项目根目录下缺少 go.mod 文件，或当前目录不在 GOPATH/src 下又未主动初始化。
实操建议：
- 新建项目时，**先 cd 进目标目录，再执行
go mod init example.com/hello**（模块名可任意，但需符合域名格式） - 若已有代码但无
go.mod，直接运行go mod init（不带参数）会尝试推导模块名，但不如显式指定可靠 - 检查
go env GO111MODULE：应为on；若为auto或off，执行go env -w GO111MODULE=on - 国内用户务必配代理，否则
go mod download会卡死：go env -w GOPROXY=https://goproxy.cn,direct
GOROOT 和 GOPATH 能否设成同一目录？
技术上可以，但**强烈不建议**。二者语义完全不同：GOROOT 是 Go 工具链自身所在（只读），GOPATH 是你放代码、下载依赖、生成二进制的地方（可写）。混用会导致权限冲突、升级 Go 时误删项目，或 go install 命令覆盖 GOROOT 下的 bin 文件。
实操建议：
-
GOROOT固定为安装路径（如/usr/local/go、C:Go） -
GOPATH单独设为用户目录下干净路径（如$HOME/go、C:UsersYougo） - 现代项目优先用 module 模式，
GOPATH仅用于存放工具（$GOPATH/bin），源码可放在任意位置
go 命令本身可执行、模块能拉取、工具能安装——三者缺一不可。最容易被忽略的是 shell 配置文件的重载和代理设置，这两步不做，其他都白搭。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
