关键在于path、goroot、goproxy三处配置正确：$goroot/bin必须前置加入path以确保which go指向/usr/local/go/bin/go；goroot须固定为安装路径，gopath推荐$home/go且仅用于存放go install二进制；国内服务器必须设goproxy=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct，否则go mod download会卡死。
自建服务器上配 Golang 环境，关键不是“装没装上”，而是go命令能否在任意路径调用、go mod能否正常拉依赖、新项目能否不踩坑直接go run。只要 PATH、GOROOT、GOPROXY 三处设错一处，后续所有操作都会卡住。
go command not found 是 PATH 没生效，不是没装
很多人解压完 /usr/local/go，执行 go version 报错，第一反应是重装——其实只是 shell 没读到新 PATH。常见原因和解法：
- 改的是
~/.bashrc，但当前终端用的是zsh：检查echo $SHELL，对应改~/.zshrc - PATH 添加顺序错误：必须把
$GOROOT/bin放在最前面或至少在$PATH前置位置，否则旧版本（如系统自带的/usr/bin/go）会优先被命中 - 没执行
source ~/.bashrc或新开终端：source只对当前 shell 生效，子进程不继承 - 用了
sudo su切换 root 后 PATH 重置：root 用户的配置文件（如/root/.bashrc）需单独配置
GOROOT 和 GOPATH 不要混用，尤其别把项目放 $GOPATH/src
Go 1.16+ 默认启用模块模式，GOPATH 已退化为存放 go install 编译出的可执行文件的目录（即 $GOPATH/bin），不再是源码根目录。旧式 $GOPATH/src/github.com/xxx 结构会干扰 go mod init 推导 module path。
-
GOROOT应固定指向 Go 安装路径（如/usr/local/go），不要随意改 -
GOPATH可保持默认（$HOME/go），仅用于go install输出二进制；若想隔离，设为/data/go并确保$GOPATH/bin在 PATH 中 - 新建项目**不要进入
$GOPATH/src目录**再go mod init，直接在/home/user/myapp这类任意路径操作即可 - 验证方式：
go env GOPATH和go env GOROOT必须输出明确路径，且which go返回/usr/local/go/bin/go而非/usr/bin/go
国内服务器必须配 GOPROXY，否则 go mod download 卡死
自建服务器常位于内网或受限网络，不设代理时 go mod download 会卡在 proxy.golang.org 或校验失败（verifying github.com/xxx@v1.2.3: checksum mismatch）。这不是 Go 本身问题，是模块分发链路不可达。
- 推荐设置清华源：
go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct - 若仍报 checksum 错误，临时关闭校验（仅限开发机）：
go env -w GOSUMDB=off；生产环境应保留校验，改用可信代理如GOSUMDB=sum.golang.org配合代理 - 验证代理是否生效：运行
go mod download github.com/spf13/cobra@v1.8.0，成功则立即返回，无超时或 404 - 注意：代理设置对当前用户生效，root 和普通用户需分别执行
go env -w
go run 能跑不等于环境真可用，得测 go install 和 gopls
很多教程只验证 go run hello.go 就算成功，但实际开发中更常遇到的问题是：go install 出的命令找不到、VS Code 里 gopls 启动失败、跳转不到标准库函数。这些都指向更深层的配置缺失。
-
go install golang.org/x/tools/gopls@latest后，检查which gopls是否返回$GOPATH/bin/gopls；如果返回空，说明$GOPATH/bin不在 PATH - 在项目根目录运行
go mod init example.com/test，再创建main.go写fmt.Println(time.Now())，go run应能自动 resolvetime包——这验证了模块解析链路 - 若用 VS Code Remote-SSH 连接，确保远程服务器已安装
gopls且本地 Go 插件未强制使用本地go二进制（插件设置里关掉 “Use Local Go”） - 交叉编译测试（可选）：
GOOS=linux GOARCH=arm64 go build -o app-arm64 .，确认GOROOT下的pkg/tool有对应平台工具链
真正容易被忽略的点是：不同用户（root / deploy / yourname）的环境变量彼此独立，go env 输出可能完全不同；而 systemd 服务或 cron job 执行时根本不会加载 ~/.bashrc，必须显式指定 GOROOT 和 PATH。别只在交互式终端里验证成功就认为万事大吉。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
