go version能运行但go run报cannot find main module，说明Go二进制正常，但当前目录未初始化模块；需在含main.go的根目录执行go mod init example.com/myapp生成go.mod，且应设GO111MODULE=on强制启用模块模式。
go version 能输出但 go run 报 cannot find main module
说明 Go 二进制本身可用，但当前目录没被识别为模块根——这不是安装失败，是模块系统没激活。
- 必须在项目根目录（含
main.go的目录）执行go mod init example.com/myapp，模块名只要合法就行，不需真实存在 - 执行后会生成
go.mod，里面记录模块路径和 Go 版本；之后go run main.go才能正常解析导入路径 - 如果目录在
$GOPATH/src下且GO111MODULE=auto（默认），Go 会退回到旧的 GOPATH 模式，忽略go.mod；此时应设go env -w GO111MODULE=on强制启用模块
go 命令提示 command not found 或 'go' is not recognized
根本问题不是没装 Go，而是 shell 找不到 go 可执行文件——PATH 配置错或没生效。
- 先确认 Go 安装路径：
ls /usr/local/go/bin/go（macOS/Linux）或dir C:\Go\bin\go.exe（Windows） - PATH 必须包含完整 bin 路径：
/usr/local/go/bin（不能只写/usr/local/go），Windows 是C:\Go\bin - Zsh 用户改
~/.zshrc，Bash 用户改~/.bashrc，加完要source ~/.zshrc；验证用echo $PATH | grep go - Windows 用户注意：PATH 修改后需重启终端，或新开 CMD/PowerShell，旧窗口不会自动加载新变量
go run 成功但 import 第三方包报 cannot find module providing package
模块已初始化，但依赖没下载或路径不匹配——Go 不会自动拉取未显式声明的包。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 确保
import语句里的路径（如"github.com/sirupsen/logrus"）和实际代码里写的完全一致，大小写、/v2后缀都不能错 - 运行
go mod tidy：它会扫描所有.go文件中的import，补全go.mod并下载对应版本 - 私有仓库（如
git.example.com/mylib）必须配go env -w GOPRIVATE=git.example.com，否则默认走公网代理，404 - 如果用了
replace，检查是否拼错模块路径，或replace目标本身又引入了冲突版本；临时禁用可加-mod=readonly参数
Linux/macOS 下 permission denied 写入 ~/go 或 go mod download 失败
常见于用 sudo tar 解压或脚本安装后，~/go 目录归属变成 root，普通用户无权写入。
立即学习“go语言免费学习笔记（深入）”；
- 检查权限：
ls -ld ~/go，若 owner 列显示root，就是它 - 修复命令：
sudo chown -R $(whoami) ~/go - 更稳妥做法：一开始就避免
sudo，把 Go 解压到用户目录，比如tar -C $HOME -xzf go*.tar.gz，再设GOROOT=$HOME/go - 顺手清理残留缓存：
go clean -modcache，否则旧的 root 权限模块仍会卡住后续操作
go env 输出，再盯住 go.mod 和当前工作目录，比盲目重装有效得多。 
