依赖 实验性
mise deps 命令通过对源文件进行哈希处理来管理项目依赖 （例如，package-lock.json），并在检测到更改时运行安装命令。 它还可以添加和移除单个包。
快速开始
# 启用实验性功能
export MISE_EXPERIMENTAL=1
# 安装所有项目依赖
mise deps
# 添加一个包
mise deps add npm:react
# 添加一个开发依赖
mise deps add -D npm:vitest
# 移除一个包
mise deps remove npm:lodash配置
在 mise.toml 中配置依赖提供程序：
# 内置 npm 提供程序（自动检测锁文件）
[deps.npm]
auto = true # 在 mise x/run 之前自动运行
# 适用于其他包管理器的内置提供程序
[deps.yarn]
[deps.pnpm]
[deps.bun]
[deps.deno]
[deps.aube]
[deps.go]
[deps.pip]
[deps.poetry]
[deps.uv]
[deps.bundler]
[deps.composer]
# 禁用特定提供程序
[deps]
disable = ["npm"]内置提供者
mise 为常见的包管理器提供了内置提供者：
| 提供者 | 源文件 | 输出 | 命令 |
|---|---|---|---|
npm | package.json, package-lock.json | node_modules/ | npm install |
yarn | package.json, yarn.lock | node_modules/ | yarn install |
pnpm | package.json, pnpm-lock.yaml | node_modules/ | pnpm install |
bun | package.json, bun.lock, bun.lockb | node_modules/ | bun install |
deno | deno.json, deno.jsonc, package.json, deno.lock | node_modules/ | deno install |
aube | package.json, aube-lock.yaml | node_modules/ | aube install |
go | go.mod | vendor/ 或 go.sum | go mod vendor 或 go mod download |
pip | requirements.txt | .venv/ | pip install -r requirements.txt |
poetry | pyproject.toml, poetry.lock | .venv/ | poetry install |
uv | pyproject.toml, uv.lock | .venv/ | uv sync |
bundler | Gemfile, Gemfile.lock | vendor/bundle/ | bundle install |
composer | composer.json, composer.lock | vendor/ | composer install |
dart | pubspec.yaml, pubspec.lock | .dart_tool/ | dart pub get |
flutter | pubspec.yaml, pubspec.lock | .dart_tool/ | flutter pub get |
只有在 mise.toml 中显式配置且其锁文件存在时，内置提供者才会启用。
Monorepo
默认情况下，mise deps 只运行当前配置根目录中的提供程序。要运行每个显式配置的 monorepo 根目录中的提供程序，请使用 --monorepo：
monorepo_root = true
[monorepo]
config_roots = ["apps/*", "packages/*"]mise deps --monorepo这要求显式设置 [monorepo].config_roots；mise 不会搜索任意子目录中的依赖提供程序。monorepo 根配置中的提供程序也会被包含，因为该配置属于每个选定配置根目录的层级结构，这与 mise install --monorepo 的行为一致。
Monorepo 提供程序 ID 包含其配置根目录，因此同一个提供程序可以出现在多个项目中。例如，两个 uv 提供程序分别命名为 //apps/api:uv 和 //apps/worker:uv。在使用 --only、--skip 或位置参数形式的提供程序参数时，请使用限定名称：
mise deps --monorepo --only //apps/api:uv
mise deps install //apps/worker:uv --monorepo不带 // 前缀的提供程序依赖项会在同一配置根目录中解析。因此，apps/api 中配置了 depends = ["uv"] 的提供程序依赖于 //apps/api:uv。
对于单个嵌套项目，dir 选项仍然是更简单的替代方案：
[deps.uv]
dir = "apps/api"添加和移除包
mise deps add 和 mise deps remove 命令让你可以使用 ecosystem:package 语法管理单个包：
# 添加包
mise deps add npm:react
mise deps add npm:@types/react@19
mise deps add -D npm:vitest # 开发依赖
# 移除包
mise deps remove npm:lodashecosystem 前缀告诉 mise 使用哪个包管理器。目前支持用于 add/remove 的 ecosystem 有：npm、yarn、pnpm、bun、deno、aube、dart、flutter。
自定义提供者
为项目特定的构建步骤创建自定义提供者：
[deps.codegen]
sources = ["schema/*.graphql", "codegen.yml"]
outputs = ["src/generated/"]
run = "npm run codegen"
description = "生成 GraphQL 类型"
[deps.prisma]
sources = ["prisma/schema.prisma"]
outputs = ["node_modules/.prisma/"]
run = "npx prisma generate"提供者选项
| 选项 | 类型 | 描述 |
|---|---|---|
auto | bool | 在 mise x 和 mise run 之前自动运行（默认：false） |
sources | string[] | 用于检查变更的文件/模式 |
outputs | string[] | 提供者被视为最新时必须存在的文件/目录 |
run | string | 过时时要运行的命令 |
env | table | 要设置的环境变量 |
dir | string | sources、outputs 和命令的基础目录 |
description | string | 输出中显示的描述 |
depends | string[] | 此提供者运行前必须完成的其他提供者名称 |
timeout | string | 运行命令的超时时间，例如 "30s"、"5m"（默认：无超时） |
如果省略这些选项，内置提供者会使用其文档中规定的源文件和输出。设置 sources 或 outputs 会替换该提供者的默认值，而不是在其基础上添加内容。空数组（例如 outputs = []）会显式禁用该类路径跟踪；它还会禁用内置提供者提供的任何可选输出。
相对路径和 glob 模式会在应用 dir 后从提供者的配置根目录解析。绝对路径则按原样使用。例如，某个将已安装包保存在应用程序目录下的 pnpm 工作区可以覆盖根级默认值：
[deps.pnpm]
sources = ["pnpm-lock.yaml", "packages/app/package.json"]
outputs = ["packages/app/node_modules"]模板和环境变量
提供者配置中的字符串值支持 Tera 模板，例如 {{ config_root }}、{{ env.NAME }} 和 {{ vars.name }}。Shell 风格的环境变量，例如 $NAME 和 ${NAME:-default}，会在 Tera 模板之后展开，并使用与 [env] 值相同的 env_shell_expand 设置。
[vars]
package = "api"
[deps.codegen]
sources = ["{{ config_root }}/schemas/$SCHEMA_NAME.graphql"]
outputs = ["{{ config_root }}/generated/${SCHEMA_NAME:-default}/"]
dir = "{{ config_root }}"
env = { OUTPUT_PACKAGE = "{{ vars.package }}-$BUILD_MODE" }
run = "npm run codegen -- $OUTPUT_PACKAGE"run 中的 $VAR 表达式会留给提供者的 shell，在执行时展开。这样一来， run 就可以使用提供者 env 表中的值。run 中的 Tera 表达式会在加载提供者配置时渲染。
提供者 ID 和环境变量名称不会进行模板化。无效的 Tera 模板会在提供者命令启动前作为配置错误报告。未定义的 Shell 风格变量会在发出警告后保持不变；使用 ${NAME:-} 可将其显式默认为空字符串。
新鲜度检查
mise 使用 blake3 哈希来确定自上次成功运行以来，源文件或有效提供者命令是否发生了更改。哈希存储在 $MISE_STATE_DIR/deps/<hash>.toml 中，并以项目根目录为键（因此不会在项目目录内写入任何内容）。命令哈希包含运行命令、shell、提供者 env 和工作目录；原始命令和环境值不会存储在状态中。
- 计算所有源文件的 blake3 哈希
- 计算有效提供者命令的 blake3 哈希
- 与上次成功运行时存储的哈希进行比较
- 如果源文件或有效命令被添加、移除或更改，则提供者会被视为过期
这意味着：
- 如果修改了
package-lock.json，node_modules/将被视为过期 - 如果
node_modules/不存在，提供者始终会被视为过期 - 如果源文件不存在，提供者会被视为最新（无需执行任何操作）
- 首次运行时（没有存储的状态），提供者始终会被视为过期
- 命令哈希功能启用前创建的状态，会通过运行每个提供者一次来迁移
自动安装
当在提供程序上设置 auto = true 时，它会在以下命令之前自动运行：
mise run（任务执行）mise x（执行命令）
这确保在运行任务或命令之前，依赖始终保持最新。
要在单次调用中跳过自动安装：
mise run --no-deps build
mise x --no-deps -- npm test过期警告
当使用 mise activate 时，如果任何自动启用的提供者存在过期依赖，mise 会发出警告：
mise WARN deps: npm may need update, run `mise deps`可以通过以下方式禁用：
[settings]
status.show_deps_stale = falseCLI 用法
# 安装所有项目依赖
mise deps
# 仅安装特定提供程序
mise deps install npm
# 显示某个提供程序为何是最新或过期
mise deps install npm --explain
# 显示将要执行的内容，但不实际运行
mise deps install --dry-run
# 即使输出是最新的也强制运行
mise deps install --force
# 列出可用的 deps 提供程序
mise deps install --list
# 跳过特定提供程序
mise deps install --skip npm
# 添加/移除包
mise deps add npm:react
mise deps remove npm:lodash依赖
提供者可以使用 depends 字段声明对其他提供者的依赖。提供者会在运行前等待其所有依赖成功完成。
[deps.uv]
auto = true
[deps.ansible-galaxy]
auto = true
depends = ["uv"]
run = "ansible-galaxy install -r requirements.yml && touch .galaxy-installed"
sources = ["requirements.yml"]
outputs = [".galaxy-installed"]在这个示例中，ansible-galaxy 会在开始之前等待 uv 完成。
没有 depends 的提供者仍然会像以前一样并行运行。如果某个依赖失败，所有依赖它的提供者都会被跳过。系统会检测循环依赖，并跳过受影响的提供者，同时给出警告。
并行执行
依赖提供程序会并行运行，并遵守 jobs 设置所定义的并发限制。 当多个提供程序需要运行时（例如 npm 和 pip 同时需要运行），这可以加快安装速度。 带有 depends 的提供程序会等待其依赖项完成后再开始， 而相互独立的提供程序则会并发运行。
[settings]
jobs = 4 # 同时最多运行 4 个提供程序示例：全栈项目
# 面向具有 Node.js 前端和 Python 后端的项目的 mise.toml
[deps.npm]
auto = true
[deps.poetry]
auto = true
[deps.prisma]
auto = true
depends = ["npm"] # 需要先有 node_modules
sources = ["prisma/schema.prisma"]
outputs = ["node_modules/.prisma/"]
run = "npx prisma generate"
[deps.frontend-codegen]
depends = ["npm"] # 需要先有 node_modules
sources = ["schema.graphql", "codegen.ts"]
outputs = ["src/generated/"]
run = "npm run codegen"运行 mise deps 会并行安装 npm 和 poetry 依赖，然后运行 prisma 和 frontend-codegen（同样是并行运行，因为它们只依赖于 npm，而不依赖彼此）。