go命令可用需满足go version能输出版本信息；创建main.go并go run可输出Hello, Go!；若报cannot find main module需go mod init初始化模块；常见错误多因路径、权限、中文引号或缺少.go文件导致。
确认 go 命令是否可用
打开终端（macOS/Linux）或命令提示符/PowerShell（Windows），直接运行：
go version
如果输出类似 go version go1.22.0 darwin/arm64，说明 go 已加入系统 PATH 且可执行；若提示 command not found 或 'go' is not recognized，需检查安装路径是否添加到环境变量（如 macOS 的 ~/.zshrc、Windows 的系统环境变量 PATH）。
创建并运行一个最简 main.go
新建目录（例如 ~/go-test），进入后创建文件 main.go，内容如下：
package main
import "fmt"
func main() {
fmt.Println("Hello, Go!")
}
在该目录下执行：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
go run main.go
预期输出 Hello, Go!。注意：go run 会编译并立即执行，不生成可执行文件；若想生成二进制，用 go build main.go，然后运行 ./main（Linux/macOS）或 main.exe（Windows）。
检查 GOPATH 和模块初始化（Go 1.13+ 推荐）
现代 Go 默认启用模块（modules），无需手动设置 GOPATH。但首次运行 go run 时若报错 go: cannot find main module，说明当前目录不在模块内。此时应运行：
-
go mod init example.com/test（模块名可任意，只需是合法导入路径） - 再执行
go run main.go就能正常工作 - 该命令会生成
go.mod文件，记录模块名和 Go 版本
不初始化模块也能运行单文件，但涉及依赖或后续扩展时，模块是必需的。
常见失败现象与对应排查点
以下错误往往不是安装失败，而是环境或操作细节疏漏：
-
cannot load fmt: cannot find module providing package fmt：通常因误删了 Go 安装目录下的src或pkg，重装 Go 即可 -
permission denied（Linux/macOS）：检查go二进制是否具有可执行权限（ls -l $(which go)） -
invalid character U+201C：复制代码时混入中文引号（“”），务必使用英文双引号" -
build failed: no Go files in ...：当前目录下没有.go文件，或文件名含非法字符（如main.go.txt）
真正安装失败的情况极少——只要 go version 能输出，99% 的问题出在路径、权限、编码或模块状态上。
