必须使用官方二进制包安装Go，禁用apt/yum等系统包管理器；因后者版本滞后、GOROOT硬编码、缺失工具链、不支持模块且多用户共享易致环境崩溃。
直接装官方二进制包，别碰系统包管理器；每个用户必须私有化配置 GOROOT、GOPATH 和 GOPROXY，否则 go build 会静默失败或卡在 go mod download。
为什么不能用 apt install golang 或 yum install golang
系统包管理器装的 Go 多数是旧版（如 Ubuntu 22.04 自带 go1.18），缺失 src 和完整 pkg/tool 目录，导致 go tool compile、go build -buildmode=shared 直接报错。更严重的是：所有用户共用一个 GOROOT，一旦有人误删或升级，整个开发链就断。
-
go: cannot find main module—— 常见于GO111MODULE=auto且项目根目录无go.mod，本质是退化回 GOPATH 模式，但系统包又没配好路径 -
exec: "gcc": executable file not found in $PATH—— 实际是GOROOT不完整，找不到pkg/tool/linux_amd64/compile，不是真缺 gcc - CentOS 7.9 等老系统自带的
golang包甚至不支持go mod，go mod init会直接报错
Linux 服务器上正确安装 Go 并配置环境变量
必须用官方二进制包解压到用户私有路径，禁用全局共享。以 go1.22.5.linux-amd64.tar.gz 为例（先用 uname -m 确认架构）：
- 执行：
mkdir -p ~/local/go && curl -sL https://go.dev/dl/go1.22.5.linux-amd64.tar.gz | tar -C ~/local -xzf - - 在
~/.bashrc或~/.zshrc中追加以下五行（注意顺序，$GOROOT/bin必须在最前）：export GOROOT=$HOME/local/go export PATH=$GOROOT/bin:$PATH export GOPATH=$HOME/go export GOBIN=$HOME/bin export GOCACHE=$HOME/.cache/go-build export GOPROXY=https://goproxy.cn,direct
-
source ~/.bashrc后验证：go version和go env GOROOT GOPATH GOBIN输出路径必须全部指向用户家目录，不能含/usr/local或/opt -
GOCACHE必须设为本地路径——NFS 挂载的 home 上并发写缓存极易锁死，$HOME/.cache/go-build是安全选择
GO111MODULE 必须为 on，且项目无需塞进 $GOPATH/src
Go 1.22+ 已彻底弃用 GOPATH 路径约束。GO111MODULE=auto 是最大陷阱：有 go.mod 就启用模块，没有就 fallback 到 GOPATH 模式，造成“本地能跑、CI 报错”。
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env GO111MODULE，结果必须是on；若为auto，立即执行：go env -w GO111MODULE=on - 新建项目任意路径均可，比如
~/projects/myapi，进入后直接go mod init myapi——myapi是模块名，不是文件夹名，也不必带域名 - 错误示范：
go mod init github.com/you/myapi在私有项目里纯属冗余，还可能因域名解析失败阻塞go mod download -
go clean -modcache && go mod download是解决工具安装失败、gopls 启动异常的第一步，比重装插件管用
Windows Server 上部署 Go 服务时的 PATH 和权限陷阱
MSI 安装看似省事，但 IIS 应用池、NSSM 托管服务等场景下，go 命令常不可用——因为服务进程默认不继承用户级环境变量。
- 必须用管理员权限执行：
setx /M PATH "%PATH%;C:\Go\bin"和setx /M GOPATH "C:\gopath"，写入系统级变量 - IIS 应用池需在高级设置中开启
Load User Profile = True，否则用户级PATH不加载 - NSSM 配置服务时，在 Environment 标签页手动添加
PATH和GOPATH，不能依赖系统默认值 -
%USERPROFILE%\go在 Local System 账户下指向C:\Windows\System32\config\systemprofile，该路径默认不可写，go mod download会静默卡住；应显式设setx /M GOPATH "C:\gopath"并确保目录存在且可写
真正容易被忽略的是：不同用户、不同服务身份、不同 Shell 启动方式（登录 vs 非登录 shell）对 PATH 的加载差异极大，which go 在终端里成功，不代表 systemd 或 crontab 能调用它。每次部署前，务必在目标上下文里单独验证 go version 和 go env GOROOT。
