需切换go版本使go version与go.mod中go指令一致，而非修改go.mod；例如go.mod声明go 1.22时，应通过gvm use或手动设置goroot和path匹配版本，否则go build会硬性报错“cannot use go x.y with go z.z mod”。
go version 显示正确但 go build 报错“cannot use go X.Y with go Z.Z mod”
这是最典型的多版本共存误配现象：终端里 go version 看着对，但构建失败。根本原因是 go.mod 第一行的 go 1.22 是硬性校验门槛，不是建议值。
- 哪怕你用
asdf local golang 1.21.9切换了项目级版本，只要go.mod写着go 1.22，go build就会立刻终止 - 验证方式不是只看
go version，而是执行go env GOROOT和go list -m，确认当前生效的二进制路径与模块声明一致 - 临时绕过？不行。Go 不提供类似
--ignore-go-version的开关。要么降级go.mod中的版本声明（需确保代码没用高版本特性），要么升级本地 Go 版本
Windows 上用 go install golang.org/dl/ 后 go1.21.6 command not found
这不是安装失败，而是 PATH 没生效或路径拼写错误。官方下载器 go install golang.org/dl/go1.21.6@latest 只生成一个包装器可执行文件（如 go1.21.6.exe），它本身不带 SDK，必须配合 go1.21.6 download 才能拉取完整工具链。
-
go1.21.6.exe默认放在%USERPROFILE%\go\bin\，这个目录必须出现在系统 PATH 前端（不是末尾） - PowerShell 中执行前先运行
$env:PATH = "$env:USERPROFILE\go\bin;" + $env:PATH，否则setx修改要重启终端才生效 - 如果
go1.21.6 version报错 “The system cannot find the file specified”，说明go1.21.6 download没跑完——它会把 SDK 解压到%USERPROFILE%\go\sdk\go1.21.6，缺这步就只是个空壳
Linux/macOS 下用软链接切换 Go 版本后 IDE 仍用旧版
VS Code、GoLand 这类 IDE 启动时读取的是登录 shell 的环境变量快照，不是你当前终端里刚改的 PATH。即使 which go 在终端里返回 /usr/local/go/bin/go，IDE 可能还在调用旧路径下的二进制。
- 别依赖
source ~/.zshrc后再点开 VS Code——它不会重新加载 shell 配置 - 正确做法：关闭所有 IDE 实例 → 终端执行
code --no-sandbox --disable-gpu（或直接code .）从该 shell 启动，这样 PATH 才真正透传过去 - 验证是否生效：在 VS Code 里打开命令面板（Ctrl+Shift+P），运行 “Go: Locate Configured Go Tools”，看
gopls和go路径是否指向新软链接目标
go mod graph 显示同一模块多个版本，但代码没报错
这不一定是问题。Go 模块允许多版本共存是设计使然，只要各依赖模块彼此不暴露冲突的类型或函数签名，就能和平共处。
- 用
go list -m all | grep 'github.com/some/lib'查看实际被选中的版本；重复出现 ≠ 冲突，只代表不同路径引入了不同 minor 版本 - 真正危险的信号是
go build报type mismatch或undefined: xxx，这时才需要干预：要么用go mod edit -require=github.com/some/lib@v1.5.0强制统一，要么加replace锁定 - 别盲目删
go.sum里的多条目——那是校验和记录，删了会导致下次go mod download失败
net 包做 DNS 解析或 os/user，就得在目标平台真机上构建。这点容易被忽略，直到部署时才发现二进制启动就 panic。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
