go本地编译环境配不起来，主因是goroot与gopath混淆、gobin未生效或shell配置未重载；需先验证go version是否可用，再分平台确认安装路径与path设置，明确goroot（go根目录）与gopath/gobin（开发路径与安装输出目录）分工，并通过go mod init→build→run闭环测试，同时检查代理配置与shell加载逻辑。
Go 本地编译环境配不起来，大概率不是缺 Go，而是 GOROOT 和 GOPATH 混了、go env 输出里 GOBIN 没生效、或者 shell 启动文件没重载。
确认系统是否已装 Go 及版本是否可用
别急着改配置，先看 Go 本身能不能跑。终端执行：
go version
如果报 command not found: go，说明没装或 PATH 没导对；如果输出类似 go version go1.21.6 darwin/arm64，说明二进制存在且可执行。注意：macOS M 系列、Windows WSL、Linux x86_64 的安装包路径和默认行为有差异，不要直接复制别人家的 /usr/local/go 路径。
- macOS 用 Homebrew 装的 Go，
which go通常指向/opt/homebrew/bin/go，GOROOT会自动推导，一般不用手动设 - Windows 下从官网下载 MSI 安装包，默认会写注册表并加 PATH，但 CMD 和 PowerShell 可能缓存旧 PATH，建议重启终端或运行
$env:PATH = [System.Environment]::GetEnvironmentVariable("PATH","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("PATH","User") - Linux 手动解压 tar.gz 到
/usr/local/go后，必须确保/usr/local/go/bin在 PATH 中，且权限为可执行（ls -l /usr/local/go/bin/go应显示-rwxr-xr-x）
搞清 GOROOT 和 GOPATH 的分工
GOROOT 是 Go 安装根目录，放的是 src、pkg、bin 这些标准库和工具；GOPATH 是你写代码、放依赖、构建产物的地方——Go 1.16+ 默认启用 module 模式后，GOPATH 对构建已非必需，但它仍控制 go install 命令把可执行文件放到哪（即 GOBIN）。
立即学习“go语言免费学习笔记（深入）”；
- 用
go env GOROOT看 Go 自己认的根路径，多数情况不该手动改它 - 用
go env GOPATH看当前工作区，若为空，Go 会 fallback 到$HOME/go；你可以设成~/dev/go这类易识别路径，但别嵌套在项目目录里 - 真正影响
go install输出位置的是GOBIN：如果它被设了（比如export GOBIN=$HOME/bin），那go install .就会把二进制丢进去，否则落到$GOPATH/bin
验证 go mod 初始化与本地构建是否闭环
配置完环境变量，得立刻测一个最小闭环：新建项目 → 初始化 module → 写一行 main.go → 编译运行。卡在这步，八成是 module proxy 或 checksum db 拦路。
- 新建空目录，执行
go mod init hello，应生成go.mod文件；若报cannot determine module path，说明当前不在干净目录，或父目录有go.mod -
main.go写三行即可：
package main
import "fmt"
func main() {
fmt.Println("ok")
}
- 运行
go build -o hello .，生成可执行文件；再运行./hello输出ok，说明编译链通了 - 如果
go build卡住几秒后报go: github.com/xxx@v1.2.3: reading https://proxy.golang.org/...: 403 Forbidden，说明企业网络拦截了官方 proxy，需运行go env -w GOPROXY=https://goproxy.cn,direct（国内推荐）或go env -w GOPROXY=direct（离线开发）
Shell 配置文件加载失效是高频盲点
很多人改了 ~/.zshrc 或 ~/.bash_profile，却在新终端里 go env 还显示旧值——根本原因是 shell 没读那个文件，或读了但 export 语句写错了格式。
- 检查当前 shell 类型：
echo $SHELL，zsh 用户改~/.zshrc，bash 用户改~/.bash_profile（不是.bashrc，后者在非登录 shell 不加载） - 添加环境变量时，必须用
export GOROOT=/usr/local/go，不能只写GOROOT=/usr/local/go（这只会创建 shell 变量，不传给子进程） - 改完务必运行
source ~/.zshrc，再新开终端测试前，先echo $GOROOT看是否输出预期路径 - Windows 用户注意：PowerShell 的
$env:GOROOT设置只在当前会话有效，要永久生效得用[Environment]::SetEnvironmentVariable("GOROOT", "C:\Go", "User")
最常被忽略的其实是 GOBIN 和 shell 加载顺序——很多人以为配完 GOPATH 就万事大吉，结果 go install 出来的命令找不到，其实只是没加进 PATH，或者 GOBIN 指向了一个不存在的目录。
