Go 1.21+ 可直接用 go install 安装工具，但必须正确设置 GOROOT 和 PATH；下载须认准 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd，Linux/macOS 选 tar.gz、Windows 选 msi（自动配置 PATH），验证需用 which/where go、go env GOROOT/GOPATH 及 go run hello world 三步确认。
Go 1.21+ 已能直接用 go install 安装二进制工具，无需手动配置 $GOPATH/bin 到 $PATH ——但你仍必须设置 $GOROOT 和 $PATH，否则 go 命令根本找不到。
下载安装包时认准官方域名和后缀
从 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载，别信第三方镜像站打包的“一键安装版”。Linux/macOS 选 tar.gz，Windows 选 msi（非 zip）——msi 会自动写注册表并添加 go 到系统 PATH；zip 版必须手动配置，且容易漏掉 cmd 子目录。
- macOS Apple Silicon 要下
darwin-arm64，不是darwin-amd64 - Linux x86_64 服务器常见误下
linux-386（32 位），运行go version会报cannot execute binary file: Exec format error - Windows 用户如果用 Git Bash，装完 msi 后需重启终端，否则
which go仍返回空
验证环境是否真就绪：绕过缓存看真实路径
别只信 go version 输出。它可能来自旧版本残留或 alias。执行以下三步才能确认：
- 运行
which go（macOS/Linux）或where go（Windows CMD）——输出应为/usr/local/go/bin/go或C:\Program Files\Go\bin\go.exe，而非~/go/bin/go或某 shell 的 wrapper 脚本 - 运行
go env GOROOT，值必须和which go的父目录一致（比如/usr/local/go），否则go build会找不到标准库 - 运行
go env GOPATH，新项目建议显式设为~/go（非默认$HOME/go），避免空格或中文路径导致go mod download失败
用 go run 测试最简 hello world
别急着建 module。先在任意空目录下创建 main.go：
立即学习“go语言免费学习笔记（深入）”；
package main
import "fmt"
func main() {
fmt.Println("hello, world")
}
然后执行 go run main.go。成功输出即说明编译器、链接器、运行时三者连通。失败常见原因：
-
command not found: go→$PATH没生效，重开终端或检查 shell 配置文件（~/.zshrc/~/.bash_profile/%PATH%） -
build cache is required→go env GOCACHE路径不可写，临时改用GOCACHE=/tmp/go-cache go run main.go - 中文 Windows 上输出乱码 → 终端编码不是 UTF-8，CMD 执行
chcp 65001，PowerShell 运行[Console]::OutputEncoding = [Text.UTF8Encoding]::UTF8
真正卡住的地方往往不是安装步骤，而是 GOROOT 和 PATH 的指向不一致，或者终端没加载最新环境变量——这两个点查不到日志，只能靠 which 和 go env 对照着看。
