go环境搭建关键在正确配置goroot（通常无需手动设置）、gopath（影响go install输出和模块缓存）及启用go modules；go install默认输出到$gopath/bin，须将其加入path，项目需有go.mod且用go install .或带版本语法安装。
Go 语言环境搭建本身不难，但容易在 GOPATH、GOROOT、模块模式与 go install 行为之间混淆，导致 go run 正常而 go install 找不到命令，或 go get 报错“cannot find module providing package”。关键不是装完 Go 就算完，而是让 go 命令能一致地解析依赖、定位可执行文件、管理源码路径。
确认 Go 安装后立即验证 GOROOT 和 PATH
很多问题源于系统 PATH 没包含 Go 的 bin 目录，或手动设置了错误的 GOROOT。现代 Go（1.16+）通常不需要显式设置 GOROOT —— 安装包已内置路径，强行设置反而会冲突。
- 运行
go env GOROOT，输出应是类似/usr/local/go（macOS/Linux）或C:\Program Files\Go（Windows），且该路径下存在bin/go；如果不是，删掉 shell 配置里的GOROOT=...行 - 运行
which go（macOS/Linux）或where go（Windows），结果必须和go env GOROOT下的bin目录一致 - 如果
go version可用但go mod init报错“command not found”，大概率是 PATH 漏加了$GOROOT/bin
区分 GOPATH 模式与模块模式（Go 1.11+ 默认启用）
新手常误以为 GOPATH 仍是必需的代码存放位置。实际上，只要项目根目录有 go.mod 文件，Go 就进入模块模式，GOPATH 仅用于存放下载的依赖缓存（$GOPATH/pkg/mod）和 go install 编译的二进制（$GOPATH/bin）。
- 不必把项目放到
$GOPATH/src下；任意路径均可go mod init example.com/foo -
go install默认安装到$GOPATH/bin，所以确保该路径在PATH中，否则安装后命令不可用 - 若想改变模块缓存位置，设
GOPATH不影响模块行为，但改GOMODCACHE（如export GOMODCACHE=$HOME/.cache/go-mod）更精准
go install 从模块路径安装可执行文件的正确写法
Go 1.16+ 废弃了 go install path/to/package@version 以外的用法。直接 go install main.go 或 go install ./cmd/xxx 会失败，报错 “cannot use path@version syntax” 或 “no required module provides package”。
- 项目需有
go.mod，且模块名（module example.com/cmd）要合理；模块名不一定要可解析，但不能是main - 安装当前目录的
main包：先go mod edit -module example.com/mytool，再go install .（注意末尾的点） - 安装远程模块的某个命令：如
go install golang.org/x/tools/cmd/gopls@latest，版本后缀不可省略 - 若提示 “cannot load package: package ... is not in GOROOT”，说明路径没指向含
package main的目录，或go.mod缺失
真正卡住人的往往不是安装 Go 本身，而是后续每一步命令对路径、模块状态、环境变量的隐式依赖。多运行一次 go env 看实际值，比反复重装更有效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
