go命令能跑不等于环境真正可用，必须通过go version、go env、go run hello.go三步验证：版本输出正确、GOROOT和PATH配置无误、程序能编译运行，缺一不可。
go 命令能跑起来，就说明环境搭对了——不是靠“安装完成”弹窗，而是靠终端里实实在在打出 go version 和成功运行 go run main.go。
怎么验证 go 命令真能用？别信安装程序的“完成”提示
Windows 双击 go1.23.windows-amd64.msi、macOS 点开 go1.23.darwin-arm64.pkg、Linux 解压 tar 包，这些操作只是把二进制文件放进去，不等于 go 就进了系统 PATH。
打开终端（Windows 用 PowerShell 或 CMD，macOS/Linux 用 Terminal），直接输：
go version
如果报错 command not found 或 'go' is not recognized，说明 PATH 没配好，得回头改环境变量。
立即学习“go语言免费学习笔记（深入）”；
- Windows 安装 MSI 后通常自动加 PATH，但若用的是旧版 PowerShell 或新用户会话，需重启终端或手动运行
$env:PATH = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User") - macOS 如果用 Homebrew 安装，
brew install go后 PATH 一般已生效；但若用 pkg 安装，检查/usr/local/go/bin是否在$PATH里（echo $PATH） - Linux 手动解压到
/usr/local/go后，必须在~/.bashrc或~/.zshrc中追加export PATH=$PATH:/usr/local/go/bin，然后source ~/.zshrc（注意 shell 类型）
go mod init 为什么总报错 “cannot find module root”？
这不是权限或网络问题，而是当前目录没满足 Go Module 的基本前提：目录名不能含空格、不能是根目录（如 / 或 C:\）、不能在 GOPATH/src 下（Go 1.16+ 默认关闭 GOPATH 模式，但残留配置会干扰）。
典型错误场景：
- 在桌面建文件夹叫
my go project→ 空格导致go mod init解析失败 - 直接在
/home/user下执行go mod init myapp→ Go 认为这是 GOPATH 根，拒绝初始化模块 - 用了旧教程里的
export GOPATH=$HOME/go且没关GO111MODULE→ 即使目录合法，Go 仍尝试走 GOPATH 老路径
安全做法：新建一个干净路径，比如 ~/dev/hello，cd 进去再跑：
go mod init hello
成功后会生成 go.mod 文件，内容类似：
module hello go 1.23
go run main.go 报 “package main is not a main package” 怎么办？
Go 要求可执行程序必须有且仅有一个 package main，且其中必须定义 func main()。这个错误几乎全是文件开头写错了。
常见手误：
- 写了
package mainx或package hello→ 必须是package main - 文件里混了多个
package main（比如复制粘贴时带了另一段代码）→ Go 不允许多个 main 包共存于同一目录 - 文件扩展名不是
.go（比如保存成main.txt或没后缀）→go run只识别.go文件 - 用了中文标点或不可见 Unicode 字符（尤其从网页复制代码时）→ 检查
package关键字前后是否全是英文空格和换行
最小可用模板就是这三行，别多也别少：
package main
import "fmt"
func main() { fmt.Println("ok") }编译出的二进制文件为什么在另一台机器上打不开？
Go 默认编译的是“静态链接”二进制，但有个关键例外：它依赖目标系统的 C 标准库（libc）做 DNS 解析、线程调度等。Linux 上编译的文件，在 macOS 或 Windows 上肯定不能跑；但同是 Linux，CentOS 编译的也可能在 Ubuntu 上因 libc 版本太老而报 GLIBC_2.34 not found。
真正跨平台的做法不是“拷过去就用”，而是明确指定目标平台编译：
- 在 Linux 上编译 Windows 程序：
GOOS=windows GOARCH=amd64 go build -o app.exe - 在 macOS 上编译 Linux 程序：
GOOS=linux GOARCH=arm64 go build -o app - 想彻底避免 libc 依赖（比如部署到 Alpine）：
CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-s -w' -o app
记住：Go 的“跨平台”是指源码一次编写，通过环境变量控制编译目标——不是默认生成的文件天然兼容所有系统。
