真正装好Go需满足三条件：go命令可执行、go mod init能生成go.mod、go run能运行Hello World；仅go version成功90%后续会因模块拉取或路径错误失败。

go 命令能正常执行、go mod init 能生成 go.mod、go run 能跑通 Hello World，这三件事全做到才算真正装好了。只跑 go version 成功，90% 的人后续会卡在模块拉取或路径错误上。

为什么不能直接用 apt install golang 或 yum install golang

系统包管理器里的 golang 版本普遍滞后：Ubuntu 22.04 自带 go1.18，CentOS 7 是 go1.11，而当前稳定版已是 go1.23.10。go1.18 不支持泛型约束（type T interface{ ~int | ~string }），go1.21 以上才默认启用 embed 和更严格的模块校验。项目 go.mod 里声明 go 1.22，旧版 go 直接报错退出。

• 用 apt/yum 安装后，which go 返回的是 /usr/bin/go，但官方二进制解压后是 /usr/local/go/bin/go —— 若没把后者放在 PATH 开头，go version 看似正常，实际调用的仍是旧版
• 某些 CI 工具（如 GitHub Actions 的 ubuntu-latest）默认预装旧版 go，不显式覆盖会导致构建失败
• 系统包安装的 GOROOT 通常设为 /usr/lib/go，与官方文档和 IDE 预期不符，部分调试插件会误判路径

GOROOT 和 PATH 必须成对设置且顺序不能错

手动解压后，/usr/local/go 就是真实安装路径。必须显式声明 GOROOT，并确保 $GOROOT/bin 在 PATH 最前面：

• 写入 ~/.bashrc 或 ~/.zshrc（别写错 shell）：
  export GOROOT=/usr/local/go
export PATH=$GOROOT/bin:$PATH
• 不要写成 export PATH=$PATH:$GOROOT/bin —— 这会让系统自带的 /usr/bin/go 优先被调用
• 改完立刻 source ~/.zshrc（或对应文件），再检查：
  echo $PATH 应看到 /usr/local/go/bin 出现在最左
  which go 应返回 /usr/local/go/bin/go
• 如果用 sudo su - 切换 root 后发现 go 找不到，是因为 root 用户没加载你的 shell 配置；需单独为 root 配置，或改用 /etc/profile.d/go.sh（系统级服务如 systemd、crontab 只读这个）

不配 GOPROXY 就等于没装成功

go version 成功 ≠ 能干活。只要涉及 go mod download、go get 或 go run 时自动拉依赖，没代理就会卡住，错误信息只有 dial tcp: i/o timeout，完全不提示代理问题。

Browser Setup (No-Root Linux)

在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...

下载

• 国内用户务必执行：
  go env -w GOPROXY=https://goproxy.cn,direct
• direct 表示对私有仓库（如公司内网 Git）跳过代理，必须保留
• 验证是否生效：
  新建空目录，执行 go mod init example.com/test → go get github.com/sirupsen/logrus，几秒内完成即通
• 若仍超时，检查是否设置了公司防火墙白名单，或临时换用 https://proxy.golang.org 测试网络连通性

验证必须走完整闭环：从空目录开始 go mod init → go build → go run

很多环境看似“能跑”，一建项目就报 go: cannot find main module 或 build failed: no Go files in，本质是模块初始化失败或工作目录权限不对。

立即学习“go语言免费学习笔记（深入）”；

• 真实可用的标准操作：
  mkdir ~/tmp-go-test && cd ~/tmp-go-test
go mod init test
cat > main.go <<EOF
package main
import "fmt"
func main() { fmt.Println("OK") }
EOF
go run main.go
• 如果报 cannot find main module，说明当前目录不在模块根下，或 go.mod 没生成成功
• 如果报 no Go files in，检查 main.go 是否真在当前目录，且文件编码不是 UTF-16/带 BOM
• 如果 go build 生成二进制但运行时报 permission denied，确认目标目录有写权限（比如不要在 /root 下普通用户执行）

最常被忽略的是：系统级上下文（systemd 服务、crontab、CI runner）不读 ~/.zshrc，必须把 GOROOT 和 PATH 写进 /etc/profile.d/go.sh，且路径不能含 ~ 或变量展开——得写死成 /usr/local/go。