go version报错或显示旧版本，根本原因是path未正确配置或旧版go路径优先级更高；需检查echo $path、用which go确认实际路径，并将新版本bin目录（如/usr/local/go/bin）前置到path中，最后source配置文件生效。
go version 命令报错或显示旧版本
常见现象是执行 go version 后提示 command not found，或输出版本低于你刚安装的（比如显示 go1.19 但你装的是 go1.22）。这基本说明 PATH 没配对，或者系统读取了旧的安装路径。
- Ubuntu/Debian 用户用
sudo apt install golang安装时，二进制实际在/usr/bin/go；但如果你同时手动解压了官方 tar.gz 包到/usr/local/go，而没删掉 apt 版本，which go可能仍指向旧版 - 检查当前生效的路径：
echo $PATH，确认/usr/local/go/bin或/usr/bin在前；若顺序不对，编辑~/.zshrc（macOS / 新版 Ubuntu）或~/.bashrc，把export PATH="/usr/local/go/bin:$PATH"放在最前面 - 改完后必须执行
source ~/.zshrc（或对应 shell 配置文件），否则新开终端才生效——很多人卡在这一步，反复重装却没 reload 配置
go mod init 初始化失败：module path 不合法
运行 go mod init myproject 报错 malformed module path "myproject": missing dot in first path element，这是 Go Modules 对模块路径的硬性要求：不能是纯单词，必须含域名风格（哪怕只是本地用）。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 正确写法示例：
go mod init example.com/myproject、go mod init github.com/yourname/myproject，甚至go mod init local/myproject（只要带斜杠） - 错误写法：
go mod init myproject、go mod init hello—— Go 会拒绝，不是 bug，是设计 - 如果项目将来要开源或发布，建议直接按真实域名或 GitHub 路径设，避免后期改
go.mod和所有 import 路径
VS Code 调试时无法断点或提示 “no debug adapter”
点调试按钮后弹窗报错，或断点灰掉不生效，通常不是 Go 本身问题，而是 VS Code 的 Go 扩展链路没打通。
- 确保已安装官方
Go扩展（作者是golang.go），不是第三方“Go Language”之类名字相近但功能残缺的插件 - 扩展安装后，VS Code 会在右下角提示 “Installing tools…”，它会自动下载
dlv（Delve 调试器）；若卡住或失败，手动执行：go install github.com/go-delve/delve/cmd/dlv@latest - 检查
settings.json中是否误禁用了调试支持："go.useGoProxy": true（国内需配代理）、"go.toolsManagement.autoUpdate": true推荐开启 - 调试前务必保存文件（VS Code 默认不自动保存），且确保当前打开的是
main.go所在目录根（即含go.mod的目录），否则 Delve 找不到入口
go run main.go 正常，但 go build 后执行报 “cannot execute binary file”
尤其在 macOS 或 Linux 上交叉编译后，在目标机器运行时报这个错，本质是架构不匹配，不是权限问题。
- 先确认当前环境架构：
uname -m（常见x86_64、aarch64）；再看二进制类型：file yourapp，输出里会明确写 “ELF 64-bit LSB executable, x86-64” 这类信息 - 如果你在 Apple Silicon（M1/M2）上用默认
go build，生成的是 arm64 二进制；扔到 Intel Mac 或 Linux x86_64 服务器上就跑不了 - 跨平台编译必须显式指定：
GOOS=linux GOARCH=amd64 go build -o app-linux main.go；GOOS=darwin GOARCH=arm64 go build -o app-m1 main.go - 注意：
CGO_ENABLED=0在纯 Go 项目中可加可不加，但一旦引入 C 依赖（如 SQLite、某些加密库），就必须保持一致，否则 runtime panic
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
