统信UOS执行go报“command not found”需三步解决：一、确认APT源含main contrib non-free后sudo apt install golang；二、若GOROOT为空则手动补PATH=$PATH:/usr/lib/go/bin并source /etc/profile；三、启用Go Modules（go env -w GO111MODULE=on）并设国内代理（go env -w GOPROXY=https://goproxy.cn,direct）。
统信UOS上执行go报command not found怎么办
直接原因是go命令没进PATH，或根本没装。国产系统默认不预装Go，且APT源常需手动启用non-free组件才能提供golang包。
- 先确认源是否完整：检查
/etc/apt/sources.list每行末尾是否含main contrib non-free，缺则补全后运行sudo apt update - 优先用APT安装验证：执行
sudo apt install golang，装完立刻测go version - 若
go env GOROOT为空，说明APT未设环境变量——此时需手动补export PATH=$PATH:/usr/lib/go/bin（注意路径，UOS常用此路径而非/usr/local/go） - 别跳过
source /etc/profile或重启终端，否则PATH不生效
手动安装时GOROOT路径写错导致go无法识别
解压后GOROOT必须严格指向go二进制所在目录的父目录，比如tar -C /usr/local -xzf go1.23.4.linux-amd64.tar.gz后，go实际在/usr/local/go/bin/go，所以GOROOT只能是/usr/local/go，多一级少一级都不行。
-
which go无输出？先查echo $PATH里有没有$GOROOT/bin，再确认$GOROOT本身是否存在且可读 - 编辑
/etc/profile时，别用~代替$HOME——shell在系统级配置中不展开~ - 用户级配置（如
~/.bashrc）只对当前用户生效，sudo su后仍无效，这是预期行为，不是bug
Go Modules代理没设导致go mod download超时失败
国内直连proxy.golang.org基本不通，不设代理就卡在依赖下载，错误常表现为Get "https://proxy.golang.org/...": dial tcp: i/o timeout。
- 立即生效的命令：
go env -w GOPROXY=https://goproxy.cn,direct（注意direct不能省，否则私有模块拉不到） - 验证是否生效：
go env GOPROXY应输出设置的地址，而非https://proxy.golang.org - 如果项目已存在
go.mod但之前没设代理，先删掉go.sum再跑go mod download，避免缓存旧失败记录
生产环境必须开GO111MODULE=on但没人提醒你
Go 1.16+默认开启Modules，但部分旧系统或容器镜像仍可能关闭。关着时go build会忽略go.mod，直接扫GOPATH/src，导致依赖版本混乱、CI构建失败。
立即学习“go语言免费学习笔记（深入）”；
- 强制开启：
go env -w GO111MODULE=on - 验证：
go env GO111MODULE输出必须是on，不是auto或空 - 别依赖
auto模式——它只在有go.mod时才启用，而某些脚本或IDE会绕过这个判断
路径、代理、模块开关这三项漏掉任意一个，都会让后续所有操作卡在第一步。国产系统尤其要盯紧GOROOT实际路径和GOPROXY可用性，这两处错得最隐蔽。
