go version报错或显示旧版本说明go二进制未被系统正确识别，常见于安装后未刷新shell环境或path中存在多个go安装路径冲突；需运行which go确认路径、source重载配置、检查goroot并统一安装方式。
go version 命令报错或显示旧版本
说明 Go 二进制未被系统正确识别，常见于安装后未刷新 shell 环境，或 PATH 中存在多个 Go 安装路径导致冲突。
- 先运行
which go查看当前生效的go路径，确认是不是你刚装的版本（如/usr/local/go/bin/go） - 如果输出是
/opt/homebrew/bin/go（macOS 上通过 brew 安装），而你又手动装了 pkg 版本，两者会打架；建议统一用一种方式安装，删掉冗余的go二进制 - 执行
source ~/.zshrc（zsh）或source ~/.bash_profile（bash）重载配置，别只改文件不 reload - 检查
GOROOT是否指向真实安装目录（go env GOROOT），若为空或错误，需手动导出：export GOROOT=/usr/local/go
go mod init 初始化失败：no modules found
Go 1.16+ 默认启用模块模式，但若项目目录里已有 vendor/ 或残留的 GOPATH 风格结构，go mod init 可能静默失败或生成异常 go.mod。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 确保当前目录是空的或只含源码文件（无
src/、pkg/、bin/等 GOPATH 旧结构） - 运行前先清理：
rm -rf vendor go.mod go.sum，再执行go mod init example.com/myapp - 模块名不必真实可访问，但建议用有意义的域名前缀（如
github.com/yourname/project），避免用main或test这类保留字 - 若提示
go: cannot find main module，说明当前不在模块根目录——go.mod必须在项目顶层，且所有.go文件应在其下
VS Code 的 Go 扩展无法自动下载依赖
现象是保存 import "github.com/sirupsen/logrus" 后没自动 go get，或弹出“Failed to install gopls”错误。
- 首要检查代理：
go env GOPROXY应为https://goproxy.cn或https://proxy.golang.org；若为空，运行go env -w GOPROXY=https://goproxy.cn - 确认
GO111MODULE已开启：go env GO111MODULE输出应为on；若为auto，在非 GOPATH 下可能不触发模块行为 - VS Code 设置里搜索 “go.toolsEnvVars”，添加键值对：
"GO111MODULE": "on"和"GOPROXY": "https://goproxy.cn" - 禁用其他 Go 插件（如旧版
go-outline、gocode），只保留官方Go插件（由 golang.org/x/tools 维护）
go run 和 go build 生成的二进制行为不一致
比如 go run main.go 正常，但 go build -o app main.go 运行时报 cannot load package 或 panic，多因相对路径、嵌入文件或环境变量差异导致。
-
go run在当前目录执行，go build生成的二进制默认从自身所在目录找资源；若代码中用了os.ReadFile("config.json")，运行时需把config.json放在二进制同级目录 - 跨平台编译注意：
GOOS=linux GOARCH=amd64 go build生成的 Linux 二进制不能在 macOS 上直接运行，别混淆本地测试和交叉编译场景 - 调试时优先用
go run，上线部署用go build；若需嵌入静态资源，用embed包（Go 1.16+），而非硬编码路径 - 检查
go list -m all是否有 indirect 依赖缺失，go mod tidy可修复模块一致性
go mod tidy ——它不光拉依赖，还会校验 go.sum 签名、剔除未引用包、同步 replace 规则。跳过这步，CI 构建很可能失败。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
