macOS（尤其是Apple Silicon）上Homebrew安装Go后常见“半生效”状态：go version能运行但GOROOT异常，需检查brew --prefix go路径、PATH是否含Homebrew bin、勿手动设GOROOT、启用GO111MODULE=on、配GOPROXY、注意go build输出路径及IDE的GOROOT设置。
go version 命令能跑通但 go env 显示 GOROOT 异常
这是 macOS（尤其是 Apple Silicon）上 Homebrew 安装 Go 后最典型的“半生效”状态：终端里 go version 能输出，但 go env 里 GOROOT 是空的或指向错误路径（比如 /usr/local/go），说明 shell 没加载到 Homebrew 提供的真实 Go 二进制位置。
- 先确认真实路径：
brew --prefix go，Apple Silicon 输出类似/opt/homebrew/opt/go，其下bin/go才是你要用的 - 检查
$PATH是否包含 Homebrew 的 bin 目录：echo $PATH | grep homebrew；若无，编辑~/.zshrc加入export PATH="/opt/homebrew/bin:$PATH" - 切勿手动设置
GOROOT——Homebrew 版 Go 会自动推导，硬设会导致go install失败或模块缓存错乱
GO111MODULE=on 没生效导致 go get 报错
常见报错如 go: modules disabled 或 cannot find module providing package，本质是模块模式未启用，Go 仍试图从 GOPATH 查找依赖。
- 执行
go env -w GO111MODULE=on（注意是=on，不是=auto） - 验证是否写入：
go env GO111MODULE应输出on，而非空或auto - 如果项目目录下已有
go.mod，但go get仍失败，先删掉它再运行go mod init example.com/foo重建 - 国内用户务必同步配代理：
go env -w GOPROXY=https://goproxy.cn,direct
go run 能跑，go build 出的二进制却提示 “command not found”
这不是 Go 环境问题，而是构建产物没放对地方，或者执行时没指定路径。Go 默认不把 go build 生成的可执行文件放进 $PATH。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
go run main.go是临时编译并运行，不生成文件；go build main.go会在当前目录生成同名二进制（如main），需手动执行./main - 想让生成的文件直接可用，用
-o指定输出路径：go build -o $GOPATH/bin/mytool main.go，之后就能全局调用mytool - 检查
$GOPATH/bin是否在$PATH中：echo $PATH | grep "$GOPATH/bin"，没有就补上
多个 Go 版本共存时，go version 和实际编译行为不一致
比如 go version 显示 1.24.3，但 go build 编译出的二进制却报错说不支持某个语法（实际是旧版本特性），说明当前 shell 使用的 Go 与构建链路中隐式调用的 Go 不一致。
立即学习“go语言免费学习笔记（深入）”；
- 排查真实调用链：
which go+ls -l $(which go)，看是否被 alias、wrapper 脚本或 IDE 内置 SDK 覆盖 - VS Code / GoLand 等 IDE 通常自带 Go SDK 设置，需单独检查：Settings → Go → GOROOT，确保指向和
which go一致 - 避免混用安装方式：同一台机器上不要同时用官网 pkg、Homebrew、asdf 管理 Go，优先选一种并清理残留（尤其删掉
/usr/local/go和/etc/paths.d/go）
which go、go env、go version —— 别信记忆里的“刚才明明好了”。 
