go 1.16+无需手动设置gopath，但goroot必须正确指向安装根目录（如/usr/local/go或c:\go），且%goroot%\bin（windows）或$goroot/bin（macos/linux）须加入path；go version报错即因path未包含该路径。
go version 命令报错或不识别
说明 Go 的 bin 目录没进系统 PATH，这是最常见卡点。Windows 用户常漏掉在环境变量 Path 中添加 %GOROOT%\bin（不是 %GOPATH%\bin）；macOS/Linux 用户则容易忘记执行 source ~/.zshrc 或 source ~/.bash_profile 让配置生效。
验证方式很简单：打开新终端，直接运行：
go version
如果提示 command not found: go 或类似错误，就回到环境变量配置环节。注意不要用旧终端测试——改完变量必须新开终端，否则看不到效果。
GOPATH 和 GOROOT 还需手动设吗？
Go 1.16+ 默认启用模块（module）模式，GOPATH 已不再是强制要求。但 GOROOT 仍必须正确指向 Go 安装根目录（如 /usr/local/go 或 C:\Go），否则 go build 可能找不到标准库。
实际建议：
- Windows 安装 MSI 包时，它通常会自动设好
GOROOT和PATH，你只需确认go env GOROOT输出是否合理 - macOS 用
brew install go后，GOROOT一般为/opt/homebrew/Cellar/go/1.21.0/libexec（版本号随安装变动），无需手动设 -
GOPATH现在只影响go install到$GOPATH/bin的行为，日常开发用go run或go build不依赖它
写完 hello.go 却运行失败
典型现象是 go run hello.go 报错：package main must be declared in file 或 no Go files in current directory。根本原因只有两个：
- 文件开头没写
package main—— Go 要求可执行程序必须在main包里 - 文件里没定义
func main()—— 缺少入口函数，编译器直接拒绝 - 文件名含空格或中文（比如
我的第一个go程序.go），某些 shell 会解析失败，一律用英文下划线命名
最小合法内容就是这三行：
package main
import "fmt"
func main() { fmt.Println("hello") }
go mod init 什么时候必须执行？
当你项目需要引用第三方包（比如 github.com/gin-gonic/gin），或者想把代码发布为可复用模块时，才需要 go mod init。它会生成 go.mod 文件并记录依赖版本。
但纯本地脚本、单文件小工具（如只用 fmt 和 os）完全不用它——Go 标准库不走 module 机制，直接 import 就能用。
容易踩的坑：
- 在已有
go.mod的子目录里再执行go mod init，会导致嵌套模块，引发导入路径冲突 - 执行
go mod init myproject后，后续所有import必须以myproject/xxx开头，否则编译报错 - 如果项目路径含空格或特殊字符（如
/Users/john/my project/），go mod init会失败，先重命名目录再试
模块初始化不是环境搭建的必经步骤，别为了“仪式感”提前跑它。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
