核心问题是path、goroot、gopath是否指向真实可访问路径且顺序合理：path必须包含$goroot/bin，goroot需指向go安装根目录，gopath需规范布局，go mod init前须确保go111module=on且goproxy配置正确。
Go 环境没配好，go run 就会报错或根本找不到命令——核心问题从来不是“装没装”，而是 PATH、GOROOT、GOPATH 这三个环境变量是否指向真实可访问的路径，且顺序合理。
go 命令找不到？先查 PATH 和二进制位置
这是最常卡住的第一步。即使你解压了 go 到 /usr/local/go，如果 /usr/local/go/bin 没进 PATH，终端就完全不认识 go。
- 运行
which go或command -v go：返回空，说明PATH没生效 - 运行
ls -l /usr/local/go/bin/go（Linux/macOS）或dir C:\Go\bin\go.exe（Windows）：确认文件真实存在且有执行权限 - 检查 shell 配置文件（
~/.zshrc、~/.bashrc或%USERPROFILE%\go\bin）里是否写了export PATH=$PATH:/usr/local/go/bin，写完必须source ~/.zshrc或重启终端 - 别把
GOROOT和GOPATH的路径错贴进PATH：只有$GOROOT/bin才该加进去，$GOPATH/bin是放你本地编译的工具（比如dlv），不是 Go 自身命令
go version 能跑但 go mod init 失败？检查 GOPROXY 和模块开关
很多新手能跑 go run，却在 go mod init 后 go build 或 go get 时卡住、超时或报 no required module provides package ——这基本是代理或模块配置问题。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 运行
go env GO111MODULE：必须是on，不是auto或空；用go env -w GO111MODULE=on强制开启 - 运行
go env GOPROXY：国内环境建议设为https://goproxy.cn,direct，避免直连proxy.golang.org；用go env -w GOPROXY=https://goproxy.cn,direct设置 - 私有仓库（如
gitlab.internal.com）要加go env -w GOPRIVATE=gitlab.internal.com，否则会被代理拦截 - 注意
direct必须写在代理列表末尾，否则私有模块无法 fallback 到直连
VS Code 里代码不提示、跳转失效？gopls 没装或路径不对
VS Code 的 Go 插件依赖 gopls 提供语言服务。它不是随插件自动装好的，尤其在离线或代理异常时容易失败。
- 打开命令面板（
Cmd+Shift+P/Ctrl+Shift+P），搜 “Go: Install/Update Tools”，勾选gopls单独安装 - 装完后运行
which gopls，确认它在$GOPATH/bin下；如果不在，手动加export PATH=$PATH:$GOPATH/bin并重载终端 - VS Code 设置里检查
"go.useLanguageServer": true是否启用；禁用再启用一次可触发重连 - 项目根目录下没有
go.mod文件时，gopls功能会大幅降级——务必先go mod init example.com/myapp
go run 能跑，但 go build 出的二进制在别的机器上打不开？GOROOT 和 CGO 陷阱
Go 默认静态链接，但一旦用了 cgo（比如调 net 包里的 DNS 解析、或引入 SQLite），就会依赖系统 libc。这时候 go build 出来的程序可能只在当前机器跑得动。
- 验证是否启用了
cgo：运行go env CGO_ENABLED，默认是1；临时关闭用CGO_ENABLED=0 go build - 交叉编译要注意：比如在 macOS 上
GOOS=linux GOARCH=amd64 go build，若项目含cgo，需提前装对应平台的gcc工具链，否则直接报错 -
GOROOT不该被随意修改：除非你明确在用多版本 Go 切换（如goenv），否则保持默认值即可；改错会导致go tool compile找不到标准库
最容易被忽略的是：环境变量在不同终端、IDE、SSH 会话中可能不一致；go env 输出的是当前 shell 的视图，而 VS Code 启动时可能读的是登录 shell 的配置，也可能读的是 GUI 环境变量——这点在 macOS 上尤其明显。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
