mac/linux应优先用官方.pkg或tar.gz安装go而非homebrew，避免goroot冲突；path须正确配置/usr/local/go/bin并匹配shell类型；goproxy需设为https://goproxy.cn,direct并同步至goland环境。
直接换机器或重装系统后，go 命令突然报错、go mod tidy 卡住、Goland 里 import 全红——不是代码有问题，是环境迁移时漏掉了几个关键锚点。
Mac/Linux 别用 Homebrew 装 Go，哪怕它看起来最方便
Homebrew 安装的 go 会把 GOROOT 指向 /opt/homebrew/Cellar/go/1.26.0/libexec 这类路径，而官方 .pkg 或 tar.gz 默认装到 /usr/local/go。两者混用会导致：go env -w 写入的配置被忽略、go mod 找不到 GOROOT 下的标准库、甚至 go build 报 cannot find package "fmt"。
- Mac 用户：下载官方
go1.26.0.darwin-arm64.pkg（Apple Silicon）或go1.26.0.darwin-amd64.pkg（Intel），双击安装 - Linux 用户：解压
go1.26.0.linux-amd64.tar.gz到/usr/local，然后配PATH - 验证是否干净：
which go必须输出/usr/local/go/bin/go；go env GOROOT必须是/usr/local/go
PATH 配错了不报错，但所有命令都走旧路径
Mac 的 .pkg 安装器会写 /etc/paths，但这只对新终端生效；Linux 用户常误改 ~/.bashrc，却忘了自己用的是 zsh 或 ~/.bash_profile。结果就是 go version 显示旧版本，which go 却指向新路径——实际执行的仍是老 go。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先确认 shell：
echo $SHELL - 再确认当前
PATH是否含/usr/local/go/bin：echo $PATH | grep /usr/local/go/bin - 正确追加（以 zsh 为例）：
echo 'export PATH=/usr/local/go/bin:$PATH' >> ~/.zshrc && source ~/.zshrc - 别手动在多个配置文件里重复加
PATH，否则which go可能随机命中某一个
go mod tidy 卡住？大概率是 GOPROXY 没设对
国内直连 proxy.golang.org 基本超时，但只设 https://goproxy.cn 不够——缺 ,direct 会导致私有模块（比如公司 GitLab 地址）请求被代理拦截，返回 404 或无限重试。
- 正确命令：
go env -w GOPROXY=https://goproxy.cn,direct - 如果项目含内网仓库，必须额外加：
go env -w GOPRIVATE=git.example.com/internal - 验证：
go env GOPROXY输出应为https://goproxy.cn,direct；go env GOPRIVATE应包含你的私有域名 - Goland 用户注意：IDE 的 Go Modules 设置里
Environment字段也要同步填上这两项，否则编辑器仍报红
重装后 GOPATH 和 GO111MODULE 不用动
Go 1.16+ 已默认启用模块模式，GO111MODULE 默认就是 on；GOPATH 默认是 $HOME/go，且仅用于存放 go install 的二进制和 go get 的旧式依赖（非 module 模式）。你几乎不需要碰它。
- 别运行
go env -w GOPATH=...，除非你真有特殊目录规划 - 别手动
export GO111MODULE=on，这行配置现在纯属冗余 - 真正要检查的是：项目根目录下是否有
go.mod；go mod download是否能拉下所有依赖
最易被忽略的其实是终端配置文件的加载顺序和代理设置的 IDE 同步——它们不报错，但会让整个开发流卡在“看似正常、实则半残”的状态。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
