go version报错或显示旧版本，本质是path未生效或存在多版本冲突；需先which go确认路径，确保path包含/usr/local/go/bin等正确bin目录，再重启终端或source配置文件。
go version 报错或不显示版本，先别重装
多数人卡在这一步：终端敲 go version 提示 command not found 或输出旧版本（比如 go1.16），其实是 PATH 没生效，或系统里混着多个 Go 安装路径。
常见错误现象包括：which go 返回空、where go（Windows）列出两个路径、go env GOROOT 指向不存在的目录。
- 先运行
which go（macOS/Linux）或where go（Windows），确认实际调用的是哪个二进制 - 检查
PATH是否包含 Go 的bin目录（不是go目录本身）——例如 macOS 官方 pkg 默认装在/usr/local/go/bin，Linux tar 包解压后应加/usr/local/go/bin，Windows 是C:\Go\bin - 如果 Homebrew 装过旧版，执行
brew uninstall go再手动清理残留：rm -rf /usr/local/go和~/.go类似路径 - 改完配置后，重启终端或执行
source ~/.zshrc（macOS）、source ~/.bashrc（Linux）、refreshenv（PowerShell）
go mod init 失败或依赖拉不下来，代理和模块模式必须对齐
go mod init 成功不代表能下载依赖；国内用户最常遇到 go get 卡住、go mod tidy 报 no required module provides package 或超时，本质是 GOPROXY 和模块模式没配对。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- Go 1.16+ 默认启用模块模式，无需设
GO111MODULE=on；但若项目根目录有GO111MODULE=off环境变量，会强制退回到 GOPATH 模式，直接导致go mod命令失效 - 必须设代理：运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/golang/；同时设go env -w GOSUMDB=sum.golang.google.cn避免校验失败 - 注意
direct必须写在最后，表示对私有模块直连；漏掉它会导致内部 Git 仓库依赖失败 - 如果公司用私有 Nexus/Artifactory，要额外配
go env -w GOPRIVATE=git.internal.company.com/*
VS Code 找不到 gopls 或提示 “No packages found”，不是插件问题
VS Code 装了 Go 插件却没法跳转、补全、格式化，90% 情况是工具链没装全或权限不对，不是插件本身坏了。
- 首次打开
.go文件时，VS Code 会弹窗问“是否安装工具”，点“Install All”——但若网络不通，部分工具（如gopls、dlv）会静默失败 - 手动验证：终端进项目目录，运行
go install golang.org/x/tools/gopls@latest；成功后检查which gopls是否在$GOPATH/bin或$GOBIN下 - 如果
gopls报failed to load view，大概率是go.mod里module名含非法字符（如大写字母、下划线），改成小写加短横线，比如example.com/my-app - macOS 上若提示“已损坏”，需右键 App → “打开”，绕过 Gatekeeper；M1/M2 芯片用户确保装的是
darwin-arm64版本，不是amd64
多用户服务器上共用 Go，千万别用 sudo apt install
在 CentOS 7 或 Ubuntu 服务器上给多个开发者配 Go，用包管理器全局安装是最危险的做法：它把 GOROOT 锁死在 /usr/lib/go，且缺 src 和 pkg，导致 go build -buildmode=shared 直接失败。
- 每个用户应在自己家目录独立安装：下载
go1.22.5.linux-amd64.tar.gz，解压到~/local/go，再设GOROOT=$HOME/local/go - 显式导出
GOPATH=$HOME/go和GOBIN=$HOME/bin（确保$HOME/bin在PATH中） - 禁用
go env -w：它会把配置写进$HOME/go/env，多人共享 NFS 时易被覆盖或权限冲突；所有环境变量只通过 shell 配置文件设置 - CI/CD 脚本或定时任务必须用 login shell 启动（如
bash -l -c "go test"），否则不会加载~/.zshrc里的 Go 配置
GOBIN 和 GOCACHE 的显式控制——这些细节一旦错位，调试成本远高于重装。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
