asdf 已经改变了更新方式，不再支持 asdf update 命令。以下是新的更新方法：

1. 使用 Git 更新（推荐）

# 进入 asdf 安装目录
cd ~/.asdf

1. 拉取全部 tag 并切换到目标版本（asdf 版本即仓库 tag，git tag 可查全部可用版本）
git fetch --tags
git checkout v0.16.0

2. 全新安装（本地没有 asdf 时）

# 下载指定版本并安装
git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.16.0

注意：~/.asdf 目录已存在时 git clone 会报错，且该方式不能用于升级，此时请改用第 1 节的 Git 方式更新。

3. 更新后重新加载

# 重新加载 asdf
source ~/.asdf/asdf.sh

4. 验证更新

# 检查 asdf 版本
asdf --version

5. 更新插件

# 更新所有插件
asdf plugin update --all

6. 更新工具版本

# asdf 不能原地升级工具版本，分三步：
asdf list all   # 查看插件全部可用版本
asdf install    # 先安装新版本（写具体版本号）
asdf global    # 再切换全局版本（不能写 latest 字面量）
asdf reshim   # 最后重建 shim，使命令生效

旧版本仍保留在 ~/.asdf/installs 下，可随时切回；确认不再使用后可用 asdf uninstall 清理。

注意事项

1. 如果你使用的是自定义安装路径（不是 ~/.asdf），请相应调整路径。
2. 更新后可能需要重新配置 shell 环境（如 .bashrc 或 .zshrc）。
3. 建议定期更新插件，以获取最新功能和 bug 修复。

延伸阅读

• 开发环境（asdf+docker）——asdf 插件与工具链维护
• asdf 安装 php8.1.31+redis+swoole——asdf 安装与插件

相关文章

• 开发环境（asdf+docker）——开发环境（asdf+docker）
• asdf安装php7.4——asdf 安装 PHP 7.4
• asdf安装php8.1.31+redis+swoole——asdf 安装 PHP 8.1

asdf 系列

• 开发环境
• asdf安装php7.4
• asdf安装php8.1.31+redis+swoole
• 开发环境（asdf + docker）总览——完整配置流程