go命令找不到说明未安装，linux用apt install golang最简捷，macos/windows需配goroot、gopath及path，务必设goproxy=https://goproxy.cn并验证go version。

go 命令找不到？说明环境根本没装上，不是配错，是压根没到位。直接按你用的系统选最稳的一条路，别贪多。

Linux（统信UOS/Ubuntu/Debian）用 apt 最省事

适合只想马上写代码、不纠结版本细节的新手或临时开发机。

• 终端里跑两行：sudo apt update 然后 sudo apt install golang
• 装完立刻验证：go version 应该输出类似 go version go1.22.4 linux/amd64
• 不用手动设 GOROOT —— apt 包会自动配好；GOPATH 默认就是 $HOME/go，够用
• 坑：apt 源里的版本通常滞后 1~2 个小版本（比如官方已发 1.23.4，apt 可能还卡在 1.22.7），做兼容性验证或尝新功能时得换手动方式

Linux/macOS 手动装指定版本（推荐长期用）

要稳定、要可控、要多个版本共存，就走二进制解压 + 环境变量这条路。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

• 去 https://www.php.cn/link/42afdcd383ddd4cbf623792bafdbd6ab 下对应系统的 goX.Y.Z.linux-amd64.tar.gz 或 goX.Y.Z.darwin-arm64.tar.gz
• 解压到固定位置：sudo tar -C /usr/local -xzf goX.Y.Z.linux-amd64.tar.gz（Linux）或 tar -C /usr/local -xzf goX.Y.Z.darwin-arm64.tar.gz（macOS）
• 编辑 /etc/profile（全局）或 ~/.bashrc（仅当前用户），加这三行：

  export GOROOT=/usr/local/go
  export GOPATH=$HOME/go
  export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

• source /etc/profile 或 source ~/.bashrc 生效，再跑 go version 和 which go 确认路径对不对
• 坑：/usr/local/go 目录如果已存在旧版，必须先删掉再解压，否则文件混杂导致 go 行为异常

Windows 安装后 go 还是报“不是内部命令”？

不是没装，是 PATH 没生效，或者安装时漏勾选项。

• 重装 MSI 包，在最后一步务必勾上 Add to PATH —— 这是 Windows 版最省心的开关
• 如果已装过，手动检查系统环境变量：GOROOT 应为 C:\Go（默认），Path 里必须含 %GOROOT%\bin
• 改完环境变量，关掉所有 CMD/PowerShell 窗口，新开一个再试 go version
• 坑：用 VS Code 终端时，它可能缓存旧 PATH，重启 VS Code 才能读到最新变量

装完第一件事：必须配 GOPROXY

不配这个，go mod download 十有八九卡住或失败，跟网络有关，跟 Go 本身无关。

• 执行：go env -w GOPROXY=https://goproxy.cn,direct
• 验证：go env GOPROXY 输出应为上面那串
• 国内还有几个可用代理，比如 https://mirrors.aliyun.com/goproxy/，但 goproxy.cn 稳定性目前最好
• 坑：有些教程让你改 ~/.bashrc 里 export，但 Go 1.16+ 推荐用 go env -w 写入，避免 shell 解析歧义

装完别急着写项目，先跑个 go mod init example 看是否拉得到模块，再 go run main.go 看 Hello World 能不能过 —— 真正卡人的从来不是安装步骤，是 GOPROXY 没设、PATH 没刷、旧残留没清干净这三处。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！