Go 1.16+ 默认启用 Go Modules，GOPATH 已弱化；需设 GO111MODULE=on、配置 GOPROXY（如 goproxy.cn）、go mod init 后运行 go mod tidy，并通过 go build 生成独立可执行文件。
go version 命令报错：command not found
说明 Go 还没装进系统 PATH，不是“没装”，而是“装了但找不到”。Windows 用户常见于安装时没勾选 Add to PATH；macOS/Linux 用户则常因手动解压后没配置 $PATH。
验证方式：执行 which go（macOS/Linux）或 where go（Windows），无输出即未生效。
- Windows：重装 Go 时务必勾选 “Add Go to PATH”，或手动把
C:\Program Files\Go\bin加入系统环境变量 - macOS：在
~/.zshrc或~/.bash_profile中追加export PATH=$PATH:/usr/local/go/bin，然后source ~/.zshrc - Linux：同 macOS，路径可能是
/home/用户名/go/bin（若用二进制包解压安装）
go mod init 报错：module declares its path as … but was required as …
这是模块路径冲突，多见于复制他人项目后直接改名、或在非 GOPATH 目录下初始化却保留旧 import 路径。Go 不靠目录结构推断模块名，而严格依赖 go.mod 第一行的 module 声明。
- 先删掉旧
go.mod和go.sum - 在项目根目录运行
go mod init example.com/myapp（把example.com/myapp换成你的真实模块路径，如github.com/yourname/tool） - 再跑
go build，它会自动补全依赖并生成新go.sum
go run main.go 提示 missing GOOS/GOARCH
这不是环境问题，是命令本身被误用。Go 编译器默认以当前系统为目标平台，GOOS 和 GOARCH 只在交叉编译时显式设置，比如生成 Windows 程序给 Mac 用。
立即学习“go语言免费学习笔记（深入）”；
日常开发中，只要 go version 能正常输出，go run main.go 就不该报这个错——如果真报了，大概率是终端里残留了之前设置的环境变量：
- 检查：
echo $GOOS和echo $GOARCH，若非空，说明被污染 - 清除：
unset GOOS GOARCH（临时），或删掉 shell 配置文件里的相关 export 行 - 验证：
go env GOOS应输出darwin（macOS）、linux或windows
想立刻写个可执行文件，但不想碰 GOPATH
Go 1.16+ 默认启用 module 模式，GOPATH 已成历史概念。你现在唯一需要的，就是一个带 go.mod 的目录和一个 main.go。
三步生成独立二进制：
- 新建空目录，进入后执行
go mod init hello - 写
main.go，内容仅需：package main import "fmt" func main() { fmt.Println("Hello, Go!") } - 执行
go build -o hello ./...→ 当前目录生成hello（macOS/Linux）或hello.exe（Windows）
生成的文件不依赖 Go 环境，扔到没装 Go 的机器上也能直接运行——这才是“速成”真正的终点。
