go version报错或显示旧版本说明本地存在旧版Go或PATH未指向新安装的go二进制；Windows易因多次安装导致环境变量混乱，macOS/Linux需刷新shell配置文件；实操应先which go或where go确认路径，再校验版本与架构匹配性。
go version 命令报错或显示旧版本
说明你本地可能残留旧版 Go，或者 PATH 没指向新安装的 go 二进制。Windows 用户尤其容易因多次安装导致注册表或环境变量混乱；macOS/Linux 则常见于手动解压后没刷新 ~/.zshrc 或 ~/.bashrc。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先运行
which go（macOS/Linux）或where go（Windows），确认实际调用路径 - 若输出是
/usr/local/go/bin/go但go version显示 v1.16，说明该路径下仍是旧版 —— 直接删掉/usr/local/go整个目录再重装 - macOS M1/M2 用户注意：下载时选
arm64版本，别误用amd64；验证方式是看go version输出末尾是否为darwin/arm64 - Linux 用户解压后务必执行
export PATH=$PATH:/usr/local/go/bin，且该行必须在source前写入配置文件，否则重启终端即失效
go mod init 后 go build 报 “cannot find module”
这是 Go 1.16+ 默认启用模块模式后的典型表现：项目不在 $GOPATH/src 下，又没正确初始化模块，go build 就会拒绝编译。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不要把项目硬塞进
$GOPATH/src—— Go 1.16 起GOPATH对模块管理已无实质作用，仅影响go install的二进制存放位置 - 新建项目目录后，第一时间运行
go mod init example.com/myweb（模块名不必真实存在，但需符合域名格式） - 如果已有
main.go但忘了 init，直接补执行go mod init即可，Go 会自动推导模块名（基于当前路径），但推荐显式指定避免歧义 - 编辑器（如 VS Code）提示 “no modules found” 时，不是插件问题，而是目录下确实缺少
go.mod文件
net/http.ListenAndServe 启动后浏览器打不开 localhost:8080
最常被忽略的是端口被占用，其次是防火墙/网络策略拦截，而不是代码本身有错。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 启动前先检查端口：macOS/Linux 执行
lsof -i :8080，Windows 执行netstat -ano | findstr :8080，若有 PID 占用，用kill -9 PID（macOS/Linux）或taskkill /PID PID /F（Windows）结束 - 换端口快速验证：把
:8080改成:8081或:3000，排除端口冲突嫌疑 - Go 的
http.ListenAndServe默认绑定localhost（即 127.0.0.1），这意味着外部设备无法访问；如需局域网访问，显式用":8080"（等价于"0.0.0.0:8080"），但生产环境切勿这么用 - 某些公司内网或 macOS Monterey+ 系统会默认拦截非 HTTPS 的 localhost 请求，可临时改用
http://127.0.0.1:8080替代http://localhost:8080
VS Code 中调试 main.go 提示 “Delve not installed”
Go 扩展默认依赖 dlv（Delve）调试器，但它不会随扩展自动安装，且不同 Go 版本对 Delve 版本有兼容要求。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在 VS Code 终端中运行
go install github.com/go-delve/delve/cmd/dlv@latest，确保安装到$GOPATH/bin或go env GOPATH对应路径 - 安装后重启 VS Code，或按
Cmd/Ctrl+Shift+P→ 输入 “Go: Install/Update Tools”，勾选dlv单独安装 - 若仍报错，检查
go env GOPATH输出，并确认$GOPATH/bin已加入系统PATH—— 否则 VS Code 启动的终端找不到dlv - Delve 不支持 Windows Subsystem for Linux（WSL）下的 GUI 调试，如需图形化断点，请直接在 Windows 原生终端中开发
go mod 初始化时机、端口绑定范围、以及调试器二进制是否真在 PATH 里 —— 这三处不手动验证一遍，光看错误提示很容易绕弯。 
