必须显式配置goroot指向go安装根目录（如/usr/local/go）、gopath指向用户工作区（如$home/go），并确保$goroot/bin和$gopath/bin均加入path；漏掉任一bin路径会导致go命令或go install生成的工具无法执行。
GOROOT 和 GOPATH 必须设哪些路径才不报错
不设 GOROOT、GOBIN 和 PATH，go 命令大概率直接失败。关键路径只有两个必须显式加入 PATH：$GOROOT/bin（含 go、gofmt 等官方工具）和 $GOPATH/bin（含 go install 安装的第三方命令，如 dlv、gopls）。漏掉后者，敲 dlv 就会报 command not found。
-
GOROOT指向 Go 安装根目录，Linux/macOS 通常是/usr/local/go，Windows 是C:\Go -
GOPATH推荐设为用户目录下独立路径，比如$HOME/go或$HOME/gocode，避免和系统目录混用 -
GOBIN可显式设为$GOPATH/bin，但不是必须；只要$GOPATH/bin已加进PATH，go install生成的二进制就能直接运行
Linux/macOS 下 PATH 配置写错就丢基础命令
常见错误是写成 export PATH=$GOROOT/bin:$GOPATH/bin，漏了 $PATH: 前缀——这会覆盖整个系统路径，导致 ls、cd 全部失效。正确写法必须保留原有路径：
export GOROOT=/usr/local/go export GOPATH=$HOME/go export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
Shell 配置文件选错也白配：bash 用户改 ~/.bashrc 或 ~/.bash_profile；zsh（macOS Catalina+ 默认）必须改 ~/.zshrc。改完执行 source ~/.zshrc 生效，新开终端才认。
Windows 上 PATH 不能靠 PowerShell 临时命令搞定
PowerShell 里执行 $env:PATH += ";C:\Go\bin" 只对当前窗口有效，关掉就清空。真正生效得走图形界面：系统属性 → 高级 → 环境变量 → 用户变量，新增两行：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
GOROOT=C:\Go -
GOPATH=%USERPROFILE%\go
再在 PATH 变量末尾追加：%GOROOT%\bin;%GOPATH%\bin。改完所有已打开的 PowerShell 或 CMD 窗口都得重启，否则 go version 还是找不到。
go env -w 不等于 PATH 设置
go env -w GOPATH=/x/y 或 go env -w GOBIN=$HOME/go/bin 只影响 Go 内部行为（比如 go install 把二进制放哪），完全不修改系统 PATH。很多人设了 GOBIN 就以为能直接敲命令，结果失败——因为 Shell 根本没被告诉去哪找那个路径。
验证是否真生效，别只信 go env GOPATH，要同时检查：
-
echo $PATH（Linux/macOS）或echo %PATH%（Windows）里有没有对应 bin 目录 -
which go（Linux/macOS）或where go（Windows）输出是否指向$GOROOT/bin/go -
go install github.com/cosmos/builder/cmd/builder@latest后，直接敲builder能否运行
路径配置本身不难，难的是 shell 配置文件、系统 PATH、Go 内部环境三者之间容易脱节。每次改完，务必用实际命令验证，而不是只看变量输出。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
