答案是shims路径未加入path前端。asdf依赖~/.asdf/shims代理命令，若该路径未置于$path最前，go version仍调用旧版本；需在shell配置中添加export path="$home/.asdf/shims:$path"并source生效，再reshim或验证which go指向shim路径。
go version 显示旧版本？shims 路径没进 PATH 最前面
不是 asdf 没装好，而是 ~/.asdf/shims 根本没被 shell 读到。ASDF 不会自动改你的环境变量，它只生成代理文件，全靠你把 shim 目录塞进 $PATH 开头。
- 运行
echo $PATH，确认输出最前面有/Users/xxx/.asdf/shims（macOS）或/home/xxx/.asdf/shims（Linux） - 没有就立刻补：在
~/.zshrc（或~/.bashrc）末尾加一行：export PATH="$HOME/.asdf/shims:$PATH" - 改完必须执行
source ~/.zshrc，新开终端才生效，当前终端不会自动同步 - 验证：运行
which go，应输出~/.asdf/shims/go，而不是/usr/local/bin/go
asdf install golang 1.22 失败？版本名写错了
asdf install golang 后接的不是语义化版本号，也不是带 v 前缀的字符串，而是官方归档名——比如 1.22.1 可以，1.22 或 v1.22.1 都会失败。
- 先查可用列表：
asdf list-all golang，输出是纯文本，如1.21.0、1.22.1、1.23beta1 - 安装指定版本：
asdf install golang 1.22.1 - 装完别忘了
asdf reshim golang，否则go命令仍指向旧 shim - 插件地址必须用完整 HTTPS URL：
asdf plugin add golang https://github.com/asdf-community/asdf-golang.git，旧文档里的asdf plugin-add golang已失效
.tool-versions 不生效？位置和格式都卡点
ASDF 只向上递归找 .tool-versions，且只认项目根目录（即 go.mod 所在层）。放错位置或格式不对，就等于没写。
-
.tool-versions必须和go.mod在同一目录，不能放在cmd/、internal/或子模块里 - 内容严格为一行：
golang 1.21.6，前后无空格、无注释、无 BOM、无逗号 - 多个语言换行分隔，不是用空格或逗号拼在一起
- 运行
asdf current golang，如果输出unset，说明根本没读到配置 - 检查
.gitignore是否误屏蔽了.tool-versions——这个文件必须提交，否则协作时别人 clone 下来就是全局版本
GoLand / VS Code 里 go version 对不上？GOROOT 指向错了
IDE 不会自动识别 asdf 切换的版本，它只认你手动填的 GOROOT。填错路径，代码跳转、补全、调试全挂，但 IDE 很少报错，只表现为“没反应”。
- 打开设置 → Go → GOROOT，点 New… 手动输入路径
- 路径必须和
asdf where golang 1.22.1输出一致，不是软链接，也不是/usr/local/go - VS Code 用户注意：清空
go.goroot设置，让编辑器走系统go命令；或者设成$(shell asdf where golang)（需插件支持） - 每次切换 asdf 版本后，都要重新确认 IDE 里的
GOROOT是否同步更新
asdf current golang 的输出可能已变，但 IDE 和终端缓存没刷新——得手动验证，而不是凭印象认为“刚切过就一定对”。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
