跳转到内容

mise tool-stub

执行工具存根

工具存根是包含 TOML 配置的可执行文件,用于指定要运行的工具以及运行方式。它们提供了一种便捷的方法来创建可移植、独立的可执行文件,并自动管理工具的安装和执行。

工具存根包含:

  • 一个 shebang 行:#!/usr/bin/env -S mise tool-stub - 指定工具、版本和选项的 TOML 配置 - 可选的用于描述工具用途的注释

示例存根文件:

toml
#!/usr/bin/env -S mise tool-stub
# Node.js v20 development environment

tool = "node"
version = "20.0.0"
bin = "node"

如果缺少指定版本的工具,存根会自动安装它,并使用传递给存根的任何参数来执行它。

有关更多信息,请参阅:https://mise.jdx.dev/dev-tools/tool-stubs.html

参数

  • <FILE> — 要执行的 TOML 工具存根文件的路径

    存根文件必须包含指定要运行的工具和版本的 TOML 配置。至少应指定“version”字段。其他常见字段包括“tool”、“bin”和特定后端的选项。

  • [ARGS]… — 要传递给工具的参数

    存根文件路径之后的所有参数都会转发给底层工具。如有需要,请使用“--”将 mise 参数与工具参数分隔开。