第一步是让go命令在终端正常运行，即完成最小可行安装：下载、解压/安装、配置path并验证go version输出版本号；其他配置均为可选延展项。
学习 Go 语言的第一步不是写代码，而是让 go 命令能在终端里正常运行——这意味着你必须先完成最小可行安装：下载、解压/安装、配置 PATH，然后验证 go version 能输出版本号。其他所有配置（GOPATH、GOBIN、代理、IDE 插件）都是可选的延展项，不是“第一步”的必要条件。
go version 命令报错或找不到，说明 PATH 没配对
这是 Windows/macOS/Linux 用户最常卡住的地方。安装程序（如 go1.22.5.windows-amd64.msi）可能把 go 二进制放到了 C:\Go\bin 或 /usr/local/go/bin，但系统根本没被告知去那里找它。
- Windows：打开「系统属性 → 高级 → 环境变量」，在「系统变量」的
Path里添加%GOROOT%\bin（如果GOROOT已设）或直接填绝对路径，比如C:\Go\bin - macOS/Linux：编辑
~/.zshrc（macOS Sequoia 默认 shell）或~/.bashrc，追加一行：export PATH=$PATH:/usr/local/go/bin，然后执行source ~/.zshrc - 别信“安装完就自动生效”——重启终端或新开一个窗口再试
go version
go env 显示 GOPATH 是 ~/go，但你不想用默认路径
新版 Go（1.16+）默认启用模块模式（GO111MODULE=on），GOPATH 对日常开发已非必需。但某些工具（如旧版 gopls 或部分 CI 脚本）仍会读它；如果你坚持改，用 go env -w GOPATH=/your/custom/path 即可，无需手动改 shell 配置文件。
-
go env -w写入的是 Go 自己维护的配置，优先级高于环境变量，也比改~/.zshrc更安全 - 改完后执行
go env GOPATH确认是否生效，别只看echo $GOPATH——那个可能还是空的 - 除非你明确需要
go get到$GOPATH/src下老式工作区，否则不建议动它
go mod init 失败，提示 “cannot determine module path”
这不是环境没搭好，而是你在错误的目录下执行了命令。Go 模块初始化要求当前路径不能是 $GOPATH/src 子目录（否则会退化为老式 GOPATH 模式），也不能是空目录或根目录。
- 新建一个干净目录，比如
mkdir ~/projects/hello && cd ~/projects/hello - 确保该目录不在
$GOPATH/src里（用go env GOPATH查路径） - 运行
go mod init hello或更规范的go mod init example.com/hello（模块路径只是逻辑标识，不一定要真实存在） - 如果仍失败，检查当前目录是否包含空格或中文字符——某些旧版 Go 工具链对这类路径解析不稳定
真正容易被忽略的点是：Go 安装本身不依赖任何外部运行时（不像 Node.js 需要 Python 编译 native 模块），所以只要 go version 成功，你就已经具备编译、测试、格式化一切 Go 代码的能力。后续所有“增强体验”的步骤（代理、IDE、linter）都建立在这个基础上，别在它之前花时间折腾。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
