Bootstrap 软件包
mise 可以通过 mise.toml 中的 [bootstrap.packages] 部分确保主机软件包已安装，该配置可通过 mise bootstrap packages apply 应用，也可以作为 mise bootstrap 的一部分应用：
[bootstrap.packages]
"apk:build-base" = "latest"
"apt:libssl-dev" = "latest"
"apt:build-essential" = "latest"
"brew:postgresql@17" = "latest"
"brew:ffmpeg" = "latest"
"brew-cask:firefox" = "latest"
"flatpak:org.mozilla.firefox" = "latest"
"flatpak-user:org.gnome.Builder" = "latest"
"mas:497799835" = "latest"每一项的键为 "manager:package" —— 必须包含管理器前缀 —— 值为版本："latest" 表示由该管理器安装的最新版本，或者在支持的情况下使用该管理器原生格式的固定版本（见各管理器对应页面）。
使用表格形式可以根据操作系统或操作系统/架构限制单个软件包。os 接受单个值或列表，并使用与 [tools] 相同的名称和别名（linux、macos、windows、linux/x64、macos/arm64 等）。省略 version 时默认为 "latest"：
[bootstrap.packages]
"brew:coreutils" = "latest"
"brew-cask:1password" = { os = "macos" }
"brew-cask:font-jetbrains-mono" = { os = ["linux", "macos"] }brew-cask 条目还接受 adopt = true，用于采用已安装在 cask 目标位置且与其完全相同的应用。设置 bootstrap.brew.adopt = true 可使采用行为成为所有 cask 的默认设置，并可通过单个 cask 的 adopt = false 进行覆盖。请参阅 brew cask 文档。
主机软件包与 [tools] 有意分开： 它们不会按项目固定版本，不会获得 shim，并由平台的软件包管理器在项目外部管理——或者对于 brew 和 brew-cask，由 mise 内置的 Homebrew 安装程序管理，这些安装程序不要求安装 Homebrew 本身。请将它们用于共享库、构建依赖项和主机 GUI 应用（libssl-dev、postgresql、ffmpeg、firefox），而不是项目开发工具——后者应放在 [tools] 中。
管理器列表可通过软件包管理器插件扩展，这些插件涵盖由主机管理的状态，例如 VS Code 扩展、Helm 插件、krew 插件和 GitHub CLI 扩展。
软件包是 mise bootstrap 的组成部分之一。其他声明式配置部分的工作方式相同：
- 代码仓库 —
[bootstrap.repos] - 点文件 —
[dotfiles] - Shell 激活 —
[bootstrap.mise_shell_activate] - macOS 默认设置 —
[bootstrap.macos.defaults] - launchd —
[bootstrap.macos.launchd.agents] - systemd —
[bootstrap.linux.systemd.units] - 用户登录 Shell —
[bootstrap.user].login_shell
支持的包管理器
| 管理器 | 平台 | 页面 |
|---|---|---|
apk | Alpine Linux | apk |
apt | Debian、Ubuntu | apt |
dnf | Fedora、RHEL、CentOS、Rocky、Alma | dnf |
pacman | Arch、Manjaro | pacman |
brew | macOS (arm64)、Linux (x86_64/arm64) — 无需 Homebrew | brew |
brew-cask | macOS；Linux（字体 cask）— 无需 Homebrew | brew |
flatpak | Linux，且 flatpak CLI 位于 PATH 中（系统范围） | Flatpak |
flatpak-user | Linux，且 flatpak CLI 位于 PATH 中（用户范围） | Flatpak |
mas | macOS，且 mas CLI 位于 PATH 中 | mas |
| plugin | 由插件声明 | 包插件 |
语义
- 默认情况下采用声明式和追加式 — 条目会在 配置层级（全局 → 项目）中按键的并集进行合并。项目可以在全局列表的基础上添加软件包（并覆盖全局条目的版本固定），但不能删除它们。清理是一个显式的、限定管理器范围的破坏性操作：
mise bootstrap packages prune默认针对 Homebrew，而插件所拥有的软件包则需要使用mise bootstrap packages prune --manager <plugin>。它只会移除当前配置或受信任、可加载的已跟踪配置不再需要的软件包。 - 按操作系统筛选 —
os选择器不匹配的条目，以及当前计算机上不可用的管理器所对应的条目，都不会被执行，因此同一份配置可以跨平台使用：macOS 上会忽略apt条目，Ubuntu 上会忽略dnf条目，依此类推。brew在 macOS 和 Linux 上都可用；brew-cask在 macOS 上可用，并且在 Linux 上支持仅字体的 cask，但不提供生命周期钩子或结构化 flight 步骤；flatpak和flatpak-user在flatpakCLI 位于PATH中时可在 Linux 上使用；mas在masCLI 位于PATH中时可在 macOS 上使用。状态命令仍会列出不可用的管理器，因此不会有任何内容被静默隐藏。 - 仅手动安装 — mise 从不隐式安装系统软件包。
mise install在软件包缺失时会打印一次性提示，但只有mise bootstrap packages apply会实际安装任何内容。 - 未知管理器会在发出警告和软件包插件安装提示的情况下被忽略，因此使用较新 mise 版本中管理器的配置仍然可以解析。
对于当前用户的登录 shell 设置，请使用 [bootstrap.user].login_shell：
[bootstrap.user]
login_shell = "/bin/zsh"详情请参见 用户登录 shell。
命令
mise bootstrap packages status # 请求与已安装包的表格
mise bootstrap packages status --json # 机器可读格式
mise bootstrap packages status --missing # 如果有任何不同步则退出 1（CI 检查）
mise bootstrap packages apply # 安装任何缺失的包（先提示）
mise bootstrap packages apply apt:curl # 安装特定包（无论是否已配置）
mise bootstrap packages apply --dry-run # 打印命令而不执行
mise bootstrap packages apply --yes # 跳过确认提示
mise bootstrap packages apply --manager apt
mise bootstrap packages apply --update # 先刷新包管理器元数据
mise bootstrap packages use apk:zlib-dev apt:curl brew:jq brew-cask:firefox flatpak:org.mozilla.firefox flatpak-user:org.gnome.Builder mas:497799835
mise bootstrap packages use -g brew:ffmpeg # 写入全局配置
mise bootstrap packages use apt:[email protected] # 固定版本
# （brew 通过 formula 名称固定版本：brew:postgresql@17）
mise bootstrap packages import --manager brew # 添加已安装且被请求的 brew formula
mise bootstrap packages import --manager brew --all
mise bootstrap packages import --manager brew --dry-run
mise bootstrap packages prune --manager brew # 移除不再需要的已链接 brew formula
mise bootstrap packages prune --manager brew --dry-run
mise bootstrap packages prune --manager brew --yes
mise bootstrap packages prune --manager brew-cask # 安全移除可清理的 mise cask
mise bootstrap packages prune --manager brew-cask --dry-run
mise bootstrap packages prune --manager vscode # remove mise-owned plugin packages
mise bootstrap packages prune --manager vscode --dry-run
mise bootstrap packages upgrade # 将已安装包升级到当前版本
mise bootstrap packages upgrade --manager brew
mise bootstrap packages upgrade --manager brew-cask
mise bootstrap packages upgrade --manager flatpak
mise bootstrap packages upgrade --manager flatpak-user
mise bootstrap packages upgrade --manager masmise bootstrap packages use 是系统包的 mise use：它会向 mise.toml（默认是本地文件，使用 -g 则是全局文件）写入 "manager:package" = "version" 条目，并安装任何缺失的内容。对于当前机器上不可用的管理器，会写入条目但不会安装——这就是共享配置如何把在 Mac 上编写的 apt: 行带过去的。
mise bootstrap packages import --manager brew 是 Homebrew formulae 的反向操作：它读取当前激活的 Homebrew opt 链接，并将请求的 formulae 以 "brew:<formula>" = "latest" 的形式写入 [bootstrap.packages]。默认只导入 keg 收据表明是“按请求安装”的 formulae；传入 --all 可同时包含依赖 formulae。导入的 formulae 会在之后的 prune 运行中保留下来，因为它们现在已经在配置中声明了。
mise bootstrap packages prune --manager brew 会移除当前配置或受信任、可加载的已跟踪配置不再需要的已链接 brew formulae。这包括由真实的 Homebrew 安装的 formulae。它是 mise 的声明式清理命令，精神上类似于 Homebrew Bundle 清理，而不是 Homebrew 已移除的旧上游 brew prune 命令。
mise bootstrap packages prune --manager brew-cask 只会移除由 mise 所有、具有当前安装时收据且内容指纹未发生变化的直接产物。它会跳过旧收据、由 Homebrew 所有的 cask、pkg 和命令包装器产物、具有生命周期操作的 cask、已更改或共享的目标，以及不完整的事务。跳过操作会附带原因，并且绝不会应用 zap 元数据。
对于软件包插件管理器，prune 只会考虑 mise 在 PackageInstall 期间观察到从缺失状态转变为已安装状态的软件包。现有的或手动安装的软件包绝不会被采用。插件必须实现 PackageUninstall；试运行会打印获准的移除批次，而不会调用该钩子，并且 mise 会在更新其所有权状态前使用 PackageInstalled 验证移除结果。
mise bootstrap packages upgrade 会刷新软件包管理器元数据，并将已安装的已配置软件包升级到可用的最新版本——apk、apt 和 dnf 还会遵守配置中固定的版本（pacman、brew、brew-cask、flatpak、flatpak-user 和 mas 无法安装固定版本，因此固定版本的条目会在发出警告后跳过）。尚未安装的软件包会被跳过——这是 mise bootstrap packages apply 的工作。对于 brew，这会安装 formula 当前的 bottle 并替换旧 keg；对于 brew-cask，这会安装当前的 cask 产物；对于 flatpak 和 flatpak-user，这会在各自的范围内更新已配置的应用程序和运行时；对于 mas，这会运行 mas upgrade。
mise doctor 也会报告已配置的系统包，并在有任何缺失时发出警告。
选择要运行的管理器
默认情况下，mise 会操作当前机器上所有已配置且可用的管理器。由于可用性取决于操作系统（apt 仅存在于基于 Debian 的系统上，而 brew 在存在 bottle 的任何地方都可用），因此通常无需任何配置即可正常工作。
如果多个管理器都可能适用——例如机器上安装了多个软件包管理器，或共享配置列出了你不想在此处使用的管理器——可以使用 system_packages.managers 选择一个子集：
[settings]
system_packages.managers = ["apt"]如果你希望为不同操作系统选择不同的管理器，也可以将其与平台特定的配置文件（mise.macos.toml、mise.linux.toml）结合使用。
sudo
Linux 包管理器需要 root 权限。当未以 root 身份运行时，mise 会使用 sudo 提权，并像平常一样提示你输入密码。当 [bootstrap.user].login_shell 需要向 /etc/shells 添加一个 shell 时，也会使用相同的 sudo 路径，而且这只会在显式执行 mise bootstrap 时发生：
- 已经是 root（容器、CI）：不使用 sudo，命令直接运行
- 交互式终端：例如
sudo apt-get install ...，带有正常的 sudo 提示 - 非交互式且没有免密码 sudo：mise 会报错并打印需要手动运行的确切 命令——它绝不会因为等待密码而卡住
- 运行前会记录完整的命令行
将 system_packages.sudo = false 设置为禁止 提权；mise 会打印命令，由你自行运行。 brew 管理器除了创建 /opt/homebrew 时需要一次 sudo 外，从不需要 sudo（请参阅 brew）。 软件包插件从不使用 mise 的 sudo 路径，也绝不能自行提权。
CI 用法
在容器中，你通常已经是 root，因此不会出现提示：
mise bootstrap packages apply --yes
mise installmise bootstrap --yes 会将两者合并（并在定义了名为 bootstrap 的任务时随后运行该任务）——只需一个命令即可设置全新的机器或容器。
mise bootstrap packages status --missing 在缺少包时会以 1 退出，这使其成为一种方便的 CI 检查方式，而无需安装任何东西。