mise uninstall 命令完全指南移除已安装工具版本的原理、参数与实战【免费下载链接】misedev tools, env vars, task runner项目地址: https://gitcode.com/GitHub_Trending/mi/misemise uninstall是 misedev tools, env vars, task runner 一体化工具中用于删除已安装工具版本的核心命令。它只清理磁盘上安装的版本文件不触碰任何mise.toml配置——若想连配置一起移除应使用mise unuse。读完本文你将掌握uninstall的全部参数语义、版本匹配规则、--dry-run系列标志在脚本中的用法以及其底层删除流程、asdf/vfox 插件的bin/uninstall钩子机制和卸载后 shim 重建等源码级原理。命令概览与定位mise uninstall用于删除已安装的工具版本官方文档给出的完整签名为mise uninstall [FLAGS] [INSTALLED_TOOLVERSION]…Usage:mise uninstall [FLAGS] [INSTALLED_TOOLVERSION]…Effect:destructive — may delete or irreversibly overwrite破坏性操作可能删除或不可逆地覆盖数据Source code:src/cli/uninstall.rs需要特别强调命令的语义边界This only removes the installed version; it does not modify mise.toml. Usemise unuseto remove a tool from mise.toml and uninstall it.即uninstall只删除安装不修改mise.toml要从配置文件中移除工具声明并顺带卸载请使用mise unuse别名rm/remove。这一设计让卸载与改配置两种诉求解耦临时清掉磁盘空间用uninstall调整项目/全局工具清单用unuse。参数与标志详解位置参数参数说明[INSTALLED_TOOLVERSION]…要移除的工具可传多个形如node18.0.0从 src/cli/uninstall.rs 的 CLI 定义可以看到该参数标注为required_unless all意味着只有传了--all时才可以省略工具参数此时删除所有已安装版本。标志标志说明-a --all删除该工具的所有已安装版本-n --dry-run仅预览不真正删除任何东西--dry-run-code行为同--dry-run但若存在待卸载工具则退出码为 1适合脚本检查是否有需要卸载的内容-h --help打印帮助信息源码中is_dry_run()将dry_run与dry_run_code统一判定src/cli/uninstall.rs#L56-L58因此两者在不实际删除层面行为完全一致区别只在退出码。实战示例以下三个示例直接来自官方文档docs/cli/uninstall.md是日常使用频率最高的场景1. 卸载指定版本mise uninstall node18.0.02. 卸载当前 node 版本仅装了一个版本时mise uninstall node当省略版本时命令会解析当前配置需要的版本如果该工具只安装了一个版本则直接卸载它。3. 卸载 node 的全部已安装版本mise uninstall --all node演练--all与版本前缀的组合结合 e2e/cli/test_uninstall 这个端到端测试可以看到-a与版本前缀参数配合的威力。测试先安装dummy{1.0.0,1.1.0,2.0.0}三个版本然后mise uninstall -a dummy1 # 结果1.0.0、1.1.0 被删除2.0.0 保留这里dummy1中的1作为版本前缀匹配了所有1.x版本结合-a将匹配到的全部版本一并删除。测试还断言了后续mise uninstall -a dummy会清掉剩余的1.1.0、2.0.1等全部版本。版本匹配规则精确优先前缀兜底uninstall对版本参数的解析逻辑位于 src/cli/uninstall.rs 的get_requested_tool_versions先取该后端已安装的版本列表若存在精确匹配v query只取该版本否则按前缀匹配过滤v.starts_with(query)例如node20会命中所有20.x.y若用户显式传了tvr版本请求则同时解析出对应的具体版本加入待删集合。另外如果未使用--all且解析出的待删版本数超过了传入的工具数即一条参数匹配了多个版本命令会直接报错并提示multiple tools specified, use --all to uninstall all versionssrc/cli/uninstall.rs#L71-L73防止误删。卸载过程的底层原理1. 安装状态检查与锁在真正动手前src/backend/mod.rs 的uninstall_version会通过is_version_installed检查版本是否已安装若未安装且安装目录也不存在则打印{tool} is not installed警告并跳过src/cli/uninstall.rs#L87-L92。源码注释特别说明对目标已消失的符号链接条目也要允许删除否则名字会被占用且没有任何命令能释放它非 dry-run 模式下通过install_state::lock_tool_version获取该工具版本的状态锁避免与并发安装/卸载冲突。2. 删除内容与always_keep_download设置核心删除逻辑在uninstall_version_unlockedsrc/backend/mod.rs#L3647-L3679依次清理三个位置安装目录tv.install_path()——即~/.local/share/mise/installs/tool/version无条件删除下载缓存tv.download_path()——默认删除但若配置always_keep_download true对应环境变量MISE_ALWAYS_KEEP_DOWNLOAD见 settings.toml则保留便于调试插件/后端安装行为缓存目录tv.cache_path()——删除。删除完成后还会调用cleanup_empty_installs_dir()清理空目录并清除tool_purgatory工具炼狱待删除区中的相关路径记录src/cli/uninstall.rs#L130-L132。3. 插件卸载钩子bin/uninstall不同后端的uninstall_version_impl各不相同。以 asdf 后端为例src/backend/asdf.rs如果插件目录下存在bin/uninstall脚本卸载时会通过script_man_for_tv逐行执行该脚本再删除目录。也就是说采用 asdf 插件的工具可以在卸载时执行自定义清理逻辑如删除全局注册的符号链接、清理用户数据等这正是很多 asdf 生态插件如 Ruby、Python 等卸载行为可定制的底层机制。4. 卸载后的 shim 与运行时符号链接重建卸载完成后uninstall会刷新状态并重建 shim 与运行时符号链接src/cli/uninstall.rs#L149-L157file::touch_dir(dirs::DATA)?; let config Config::reset().await?; let ts config.get_toolset().await?; config::rebuild_shims_and_runtime_symlinks_after_removal(config, ts, removed_install_paths).await?;这意味着被卸载版本在 PATH / shim 中的残留引用会被同步清理不会出现目录已删但命令仍指向它的脏状态。测试 e2e/cli/test_uninstall 与e2e/cli/test_install_failure_runtime_symlinks都覆盖了这类移除后的符号链接一致性场景。脚本化与 CI--dry-run-code的正确用法--dry-run-code专为脚本与 CI 设计当检测到有待卸载的工具时命令以退出码 1 结束否则退出 0。官方文档的说明是Like --dry-run but exits with code 1 if there are tools to uninstall. This is useful for scripts to check if tools need to be uninstalled.源码实现src/cli/uninstall.rs#L142-L147在 dry-run 结束后若dry_run_code has_work则返回exit::request(1)其中has_work来自确实存在待删除条目的判定。e2e 测试验证了完整行为# 已安装 dummy1.0.0 时输出 uninstalled (dry-run) 且退出码非 0 mise uninstall dummy1.0.0 --dry-run-code 21 # 此时版本并未真正删除 mise ls --installed dummy # 仍包含 1.0.0 # 未安装时退出码为 0 mise uninstall dummy1.0.0 mise uninstall dummy1.0.0 --dry-run-code 21 # 成功这一模式可安全地嵌入 CI 脚本做条件清理例如在流水线中先 dry-run 探测、确认无误后再真正执行mise uninstall -a或用于编写幂等的环境清理任务。与 unuse、prune 的分工uninstall只是 mise 版本清理体系的一环三者的边界如下命令做什么修改配置典型场景mise uninstall删除已安装的版本文件否释放磁盘空间、清理特定版本mise unuse从mise.toml移除工具声明并卸载默认附带 prune是项目/全局不再需要某工具mise prune删除所有未被跟踪配置或已执行 stub 引用的版本否批量清理历史残留版本unuse源码见 src/cli/unuse.rs支持--path指定配置文件路径、--global全局配置~/.config/mise/config.toml、--env操作mise.env.toml与--no-prune只改配置不删安装。注意其版本匹配是字面量匹配要移除node 20应写mise unuse node20而不是其解析出的具体版本号。prune源码见 src/cli/prune.rs则会参考~/.local/state/mise/tracked-configs与tracked-stubs的跟踪记录删除不再被任何已跟踪配置或 stub 引用的版本可用mise ls --prunable预先查看。日常清理习惯上可以组合使用mise unuse收配置、mise prune收磁盘。小结mise uninstall是精确控制磁盘上已安装版本的命令参数支持toolversion精确与toolmajor前缀匹配-a批量删除全部版本-n/--dry-run-code保障脚本安全底层则由后端统一完成状态锁、目录删除、插件卸载钩子、purgatory 清理与 shim 重建的完整闭环。需要连带调整mise.toml时切换mise unuse即可。上述所有行为均可在 src/cli/uninstall.rs、src/backend/mod.rs 与端到端测试 e2e/cli/test_uninstall 中直接验证。相关文档Development tools工具安装、版本与插件体系总览。All commandsmise 全部命令索引。Global flags and argument syntax全局标志如-C --cd、-y --yes、-v --verbose与参数语法约定。【免费下载链接】misedev tools, env vars, task runner项目地址: https://gitcode.com/GitHub_Trending/mi/mise创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
