Go环境变量没生效的根源是PATH未包含C:\Go\bin或GOROOT配置冲突；go version报错说明PATH失效，go run失败但go build成功则表明GOPATH或模块路径异常。
Go 环境变量没生效？检查 GOPATH 和 PATH 是否冲突
Windows 上安装 Go 后执行 go version 报错或提示“命令未找到”，大概率是 PATH 没正确包含 C:\Go\bin（默认路径），或用户变量/系统变量混用导致覆盖。
常见错误现象：go env GOPATH 显示空值或指向错误目录；go run main.go 失败但 go build 成功 —— 这说明 go 命令本身能运行，但模块解析路径出问题。
- 确认
GOROOT是 Go 安装根目录（如C:\Go），不要手动设置，除非你自定义安装路径且未勾选“Add to PATH” -
GOPATH在 Go 1.16+ 已非必需，但若仍设了，必须避开系统盘根目录（如C:\go）—— 容易和GOROOT冲突 - WSL/Linux 下优先用
~/.bashrc或~/.zshrc设置PATH，别只改/etc/profile—— 否则普通用户会读不到 - 修改后务必重启终端或执行
source ~/.bashrc，Windows 用户需重启 CMD/PowerShell，而非仅新建窗口
交叉编译 Linux ARM64 二进制时 CGO_ENABLED=0 不是万能解药
想在 Windows/macOS 上构建 Linux 可执行文件，直接跑 GOOS=linux GOARCH=arm64 go build 很可能失败，报错类似 cannot use cgo with cross-compilation。此时关掉 cgo 看似合理，但要注意副作用。
-
CGO_ENABLED=0会让标准库中依赖 C 的部分（如 DNS 解析、SSL 根证书加载）退化为纯 Go 实现，可能导致连接超时或证书验证失败 - 若项目用了
net/http且需访问 HTTPS 接口，建议保留 cgo 并配好交叉工具链（如gcc-arm-linux-gnueabihf），而不是盲目禁用 - 真正轻量且安全的方案：用 Docker 构建，例如
docker run --rm -v $(pwd):/work -w /work golang:1.25-alpine go build -o myapp-linux-arm64 . - macOS M 系列芯片上交叉编译 Windows 二进制（
GOOS=windows）必须设CGO_ENABLED=0，否则链接失败 —— 这是例外，不是通则
go run 和 go build 行为差异影响调试节奏
开发阶段习惯用 go run main.go 快速验证，但上线前用 go build 打包时行为不一致，常导致“本地能跑，部署就 panic”。核心区别不在语法，而在环境感知。
立即学习“go语言免费学习笔记（深入）”；
-
go run默认忽略GOOS/GOARCH环境变量，始终按当前系统构建；go build则严格遵循，容易误以为两者等价 -
go run不生成中间文件，无法用delve附加调试已运行进程；go build -gcflags="all=-N -l"生成带调试信息的二进制后，才能用dlv exec ./myapp - 若代码里读了
os.Getenv("ENV")，go run会继承 shell 环境，而go build后执行需显式传入，比如ENV=prod ./myapp - 模块缓存位置不同：
go run可能触发go mod download到$GOPATH/pkg/mod，而 CI 环境若没清理缓存，旧版本依赖可能被复用
WebAssembly 编译失败？先确认 GOOS=wasm GOARCH=wasip1 是否匹配 Go 版本
Go 1.21 起将 WebAssembly 支持从 GOOS=wasm 升级为 GOOS=wasip1（WASI 兼容层），旧教程里的 go build -o main.wasm -target=wasm 在新版会报错 unknown target。
- Go 1.20 及之前：用
GOOS=wasm GOARCH=amd64 go build -o main.wasm - Go 1.21+：必须用
GOOS=wasip1 GOARCH=wasi go build -o main.wasm，且需搭配最新版wasmtime或浏览器运行 -
syscall/js在wasip1下不可用 —— 它只适用于浏览器环境（wasm），WASI 环境要用io、os等纯 Go 包 - 调试 wasm 二进制不能靠
println，得用fmt.Printf+ 浏览器 console 或wasmtime --invoke _start main.wasm查看 stdout
环境变量、交叉编译约束、运行时上下文、目标平台演进 —— 这些不是孤立配置项，而是相互咬合的齿轮。少调一个，整条流水线就可能卡在某个看似无关的环节。
