Mise 中文文档

外观

mise upgrade ​

  • 用法： mise upgrade [FLAGS] [INSTALLED_TOOL@VERSION]…
  • 别名： up
  • 作用： 修改状态
  • 源代码： src/cli/upgrade.rs

升级过时的工具

默认情况下，这会保持 mise.toml 中指定的版本范围不变。因此，如果你设置了 node@20，它将 升级到可用的最新 20.x.x 版本。请参阅 --bump 标志以使用最新版本 并更新 mise.toml 中的版本。

这将更新 mise.lock（如果已启用），请参阅 https://mise.jdx.dev/configuration/settings.html#lockfile。

参数 ​

  • [INSTALLED_TOOL@VERSION]… — 要升级的工具 例如：node@20 [email protected] 如果未指定，将升级所有当前工具

标志 ​

  • -b --bump — 升级到可用的最新版本，并提升 mise.toml 中的版本

    例如，如果 mise.toml 中有 node = "20.0.0"，但可用的最新版本是 22.1.0， 这将安装 22.1.0，并在配置中设置 node = "22.1.0"。

    它会保持之前版本的精度，因此如果之前是 node = "20"，它会将配置更改为 node = "22"。

  • -i --interactive — 显示多选菜单以选择要升级的工具

  • -j --jobs <JOBS> — 并行运行的任务数 小于 1 的值将按 1 处理 [默认值：4]

    环境变量： MISE_JOBS

  • -n --dry-run — 仅打印将要执行的操作，不实际执行

  • -x --exclude <INSTALLED_TOOL> — 要排除升级的工具 例如：go python

  • --dry-run-code — 类似于 --dry-run，但如果存在过时的工具，则以代码 1 退出

    这对于脚本检查工具是否需要升级很有用。

  • --inactive — 升级所有工具，包括已安装但未激活且未出现在当前配置中的工具

  • --local — 仅升级本地配置文件中定义的工具

    这只会升级项目本地 mise.toml 中定义的工具， 并跳过全局配置（~/.config/mise/config.toml）中定义的工具。

  • --minimum-release-age <MINIMUM_RELEASE_AGE> — 仅升级到在此日期之前发布或早于此时长的版本

    支持类似于 "2024-06-01" 的绝对日期，以及类似于 "90d" 或 "1y" 的相对时长。 这对于可复现性或安全目的很有用。

    这只会影响类似于 "20" 或 "latest" 的模糊版本匹配。 明确固定的版本（如 "22.5.0"）不会经过筛选。

  • --monorepo — 未来 monorepo 升级的占位标志；mise upgrade --monorepo 尚未实现。

  • --no-prune — 不卸载已被升级版本替代的版本

    旧版本会保留在原处，不会安排移除。如果 mise 之外的某些程序指向安装目录，请使用此选项。

    设置 upgrade.auto_prune = false 可使其成为默认行为。

  • --prune — 立即卸载已被升级版本替代的版本

    使用此选项可绕过 upgrade.prune_after，或在单次运行中覆盖 upgrade.auto_prune = false。

  • --raw — 将后端安装命令的 stdin/stdout/stderr 直接连接到终端。隐含使用 --jobs=1

  • -h --help — 打印帮助

弃用：

--bump 的 -l 简写已弃用，并将在 mise 2027.8.5 中移除。 移除后，-l 将成为 --local 的简写。请改用 -b 或 --bump。

示例：

# 将 node 升级到与 mise.toml 中范围匹配的最新版本
$ mise upgrade node

# 将 node 升级到最新版本并将 mise.toml 中的版本提升为该版本
$ mise upgrade node --bump

# 将所有工具升级到最新版本
$ mise upgrade

# 将所有工具升级到最新版本，并将 mise.toml 中的版本提升为该版本
$ mise upgrade --bump

# 只打印将要执行的操作，不真正执行
$ mise upgrade --dry-run

# 将 node 和 python 升级到最新版本
$ mise upgrade node python

# 升级除 go 之外的所有工具
$ mise upgrade --exclude go

# 显示多选菜单以选择要升级的工具
$ mise upgrade --interactive

# 仅升级本地 mise.toml 中定义的工具，不升级全局配置中的工具
$ mise upgrade --local