Go 1.16+ 默认启用模块模式，装完需执行 go mod init 初始化项目才能运行 go run；go version 成功不代表环境就绪，必须验证 GOMOD 是否非空、PATH 是否包含 Go bin 目录、shell 配置文件是否匹配当前 shell（如 zsh 改 ~/.zshrc），且 VS Code 需从终端启动以继承环境变量。
装完就能跑 go run，不用配一堆路径或改配置——只要选对安装方式、避开默认 shell 和 GOPATH 的坑，Windows/macOS/Linux 都能在 5 分钟内完成。
go version 能跑，不代表环境就 ready
很多人输完 go version 看到输出就以为万事大吉，结果一写 go run hello.go 就报错：cannot find module providing package fmt 或 build cache is disabled by GOCACHE=off。这不是 Go 没装好，而是模块模式（Go Modules）没被正确触发。
- Go 1.16+ 默认启用 Modules，但如果你在
GOPATH/src外新建文件、又没初始化模块，go run会拒绝执行 - 验证是否处于模块上下文：运行
go env GOMOD，输出非空路径（如/path/to/go.mod）才表示模块已激活 - 快速补救：在项目目录下执行
go mod init example.com/hello，哪怕只是临时起个名，也能让fmt等标准库正常导入
Windows 上别信“自动加 PATH”这回事
MSI 安装器确实会尝试把 C:\Program Files\Go\bin 加进系统 PATH，但实际生效要满足两个条件：命令行窗口是安装后新打开的，且没被终端缓存旧环境变量。
- 常见现象：PowerShell 里
go version成功，但 VS Code 集成终端里提示go : 无法将“go”项识别为 cmdlet - 根本原因：VS Code 启动时读取的是旧的环境快照；关掉所有终端，重启 VS Code 才能刷新
- 更稳的做法：手动确认 PATH 是否包含 Go bin 目录，用
echo $env:PATH（PowerShell）或echo %PATH%（CMD）查看 - 如果缺失，右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”里编辑
Path，新增一行C:\Program Files\Go\bin
macOS/Linux 用户小心 zsh/bash 和 .zshrc/.bashrc 的错配
macOS 自 macOS Catalina 起默认用 zsh，但很多人还在改 .bash_profile，导致 source ~/.bash_profile 后 go 命令依然找不到。
- 先查当前 shell：
echo $SHELL，输出/bin/zsh就该改~/.zshrc；输出/bin/bash才改~/.bashrc或~/.bash_profile - Homebrew 安装的 Go（
brew install go）通常装在/opt/homebrew/bin/go（Apple Silicon）或/usr/local/bin/go（Intel），不是/usr/local/go/bin，所以不要硬写后者 - 配置示例（zsh）：
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
第一次运行 hello.go，别跳过 go mod init
标准的 “Hello, Go!” 示例本身不依赖外部包，但 Go 工具链仍要求明确模块边界——否则 go run 会拒绝加载 fmt，哪怕它在标准库里。
- 错误示范：
touch hello.go && go run hello.go→ 报错no required module provides package fmt - 正确流程：
mkdir hello && cd hello go mod init hello echo 'package main\nimport "fmt"\nfunc main() { fmt.Println("Hello, Go!") }' > hello.go go run hello.go - 注意：
go mod init后生成的go.mod文件内容无关紧要，只要存在，后续所有go命令就按模块模式工作
真正卡住人的从来不是下载和安装，而是模块初始化时机、shell 配置文件错位、以及 PATH 刷新不及时——这些地方一旦漏掉，go run 就像被按了暂停键，怎么都动不了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
