mise CLI 命令参考全解从全局 Flags 到七大命令族的管理工具、环境变量与任务编排实战【免费下载链接】misedev tools, env vars, task runner项目地址: https://gitcode.com/GitHub_Trending/mi/misemisemise-en-place是一个把开发工具dev tools、环境变量env vars与任务执行器task runner统一到一个 CLI 的现代化工具链。本文以仓库中自动生成的命令行参考文档 docs/cli/index.md 为骨架结合其生成源头 mise.usage.kdlusage 规范文件与 src/cli/mod.rs 中的命令注册结构完整讲解mise的通用调用语法、全局 Flags、全部子命令家族及其典型用法帮助读者掌握用mise.toml声明工具与任务、用一套命令在 Shell、编辑器和 CI 中复现同一开发环境的完整技能。命令总览一条命令管理工具、环境与任务mise的定位一句话即可概括Dev tools, env vars, and tasks in one CLI。工具、环境变量和任务统一声明在mise.toml中mise use TOOL为当前目录的项目添加工具mise install安装配置中要求的所有内容mise run TASK执行任务。这一设计意图直接写在其 usage 规范的long_about中mise.usage.kdl也是整个 CLI 命令体系划分的内在逻辑。命令参考文档由 usage 规范自动生成文件头标注generated by usage-cli from usage spec这意味着文中所列每个命令、Flag 都与mise.usage.kdl中声明的 CLI 定义一一对应也与src/cli/目录下每个子命令模块如 src/cli/use.rs、src/cli/exec.rs、src/cli/run.rs的 Rust 实现严格同步属于所见即所得的高可信参考。通用调用语法mise [FLAGS] [COMMAND | TASK] [ARGS]…命令的作者是 Jeff DickeyjdxRust 实现about说明为 Dev tools, env vars, and tasks in one CLI。Flags 放在命令名之前mise [FLAGS] COMMAND命令名之后的参数会被原样传递给该任务。例如mise -v run build中的-v作用于 mise 自身而mise run build --prod中的--prod则传给 build 任务。方括号[]表示可选输入尖括号表示必填输入…表示参数可重复书写命令时不要输入这些记号本身。每个子命令都可用mise COMMAND --help查看随安装版本附带的完整帮助。参数[TASK][TASK]表示要运行的任务它是mise tasks run TASK的简写形式。这一点在 usage 规范中通过default_subcommand runmise.usage.kdl落实当mise的第一个位置参数不是已知子命令时会被当作任务名路由到run。也就是说mise build等价于mise tasks run build。从 spec 到文档的生成链路所有子命令页如 docs/cli/use.md都由mise.usage.kdl生成。该文件顶部用一段模板逻辑把每个命令路径映射到对应的 Rust 源码文件例如tasks/run映射到src/cli/run.rs多级子命令映射到src/cli/cmd/mod.rs随后又给出源码链接模板mise.usage.kdl因此每个命令页都附带Source code链接读者可以随时从命令直达实现。src/cli/mod.rs中以mod xxx;形式注册了全部子命令模块命令族与源码模块一一对应是核对命令是否存在的权威入口。全局 Flags所有命令共享的上下文全局 Flags 提供跨命令的共享上下文。需要特别注意文档中的两点提醒命令可以定义同名 Flag某个子命令可能定义自己的同名 Flag此时以其命令页的说明为准位置与含义可能不同。Effect 标签不是沙箱保证文档中的 effect 描述如modifies state说明命令的预期操作但配置求值、缓存刷新、必需工具的安装仍可能产生副作用。全局 Flags 一览Flag说明环境变量 / 备注-C --cd DIR运行命令前先切换目录—-E --env ENV设置加载mise.ENV.toml的环境与--profile互斥conflicts-j --jobs JOBS并行执行的 job 数量小于 1 的值按 1 处理默认 8MISE_JOBS-q --quiet抑制非错误消息MISE_QUIET覆盖--silent/--verbose/--debug等-v --verbose输出更多信息-vv更多可叠加计数覆盖--quiet等-y --yes对所有确认提示回答 yes适合脚本非交互场景--raw直接读写 stdin/stdout/stderr 而非按行处理常与管道、交互式工具搭配--locked安装时要求 lockfile 中已有预解析 URLMISE_LOCKED1或settings.lockedtrue--silent抑制所有任务输出及 mise 非错误消息比--quiet更彻底在 usage 规范中这些全局 Flag 通过global#true声明如 mise.usage.kdl并定义了彼此的覆盖关系如--quietoverrides--silent --verbose --debug-v是count型可累加。--jobs的默认值 8 与MISE_JOBS环境变量也在此声明。--locked的深意离线可复现安装--locked要求安装的工具在当前平台的 lockfile 中必须已有预解析的下载 URL否则直接失败。这可以阻止安装过程中对 GitHub、aqua registry 等 API 的实时调用从而保证离线环境或 CI 中构建的可复现性。除命令行外也可通过MISE_LOCKED1环境变量或settings.lockedtrue设置开启是配合 docs/cli/lock.mdmise lock生成 lockfile 使用的关键 Flag。专用 Flags跳过配置加载的调试开关除全局 Flags 外mise顶层还提供一组用于控制配置加载行为的开关每个都支持环境变量等价写法--no-config完全不加载任何配置文件。等价于MISE_NO_CONFIG1。--no-env不加载配置文件中的环境变量。等价于MISE_NO_ENV1。--no-hooks不执行配置文件中的 hooks。等价于MISE_NO_HOOKS1。-h --help打印帮助信息。这类开关在排查配置/环境变量/hooks 导致的异常行为时非常有用——先用--no-config跑一遍命令即可快速判断问题是否来自配置加载链路。子命令七大族功能地图与高频用法命令参考文档将全部子命令划分为七个家族下面逐一展开。每个命令的详细参数页都可在 docs/cli 目录中找到对应 Markdown 文件。1. 安装与检视工具Install and inspect tools这是日常使用频率最高的一组命令mise use别名u安装工具并写入配置。默认写入最近目录中支持的最低优先级配置文件如mise.toml而非mise.local.toml无项目配置时在当前目录创建在 home 目录运行则写入全局配置。--path指定显式文件/目录--global写个人默认配置--env写mise.ENV.toml三个选择器互斥。还支持--pin写入解析后的具体版本、--fuzzy写入模糊版本默认行为除非MISE_PIN1、--postinstall安装后执行命令、--tool-option设置工具选项如mise use --tool-option mr_boxingtontrue rust mr-boxington、--remove从配置移除工具以及--dry-run/--dry-run-code。mise install安装工具版本无参数时按配置安装全部工具。mise install-into把工具版本安装到指定路径。mise uninstall/mise unuse前者移除已安装的工具版本后者从配置中移除工具请求并清理未使用的安装。mise upgrade/mise outdated升级过时的工具 / 列出过时工具版本。mise lock创建或刷新 lockfile 的版本、校验和与下载 URL。mise latest解析工具最新匹配的版本请求。mise ls/mise ls-remote列出已安装并激活的版本 / 列出可安装的远端版本。mise tool/mise where/mise which显示工具信息 / 工具安装路径 / 可执行文件实际解析路径。mise bin-paths列出所有激活运行时的 bin 路径。mise registry/mise search列出 registry 简写名及其后端 / 在 registry 中搜索工具。mise backends/mise link/mise sync管理后端 / 将工具版本符号链接进 mise / 从其他版本管理器同步工具。mise prune/mise reshim删除未使用的工具版本 / 为已安装工具提供的可执行文件重建 shims。mise tool-stub/mise packslip执行工具 stub / 显示 mise 接受的 packslip 签名者。典型工作流示例来自 README.md 与 docs/cli/use.md# 一次性执行不改配置、无需激活 Shell mise exec node24 -- node --version # 为项目添加工具并写入配置 mise use node20 # 写入模糊版本 20 mise use --pin node20 # 写入解析后的精确版本 20.x.y mise use -g --pin node20 # 写入 ~/.config/mise/config.toml mise use cargo:ripgrep[featurespcre2] # 带工具选项的后端工具 mise use --postinstall mbx setup --defaults mr-boxington # 安装后执行命令 mise use --env staging node20 # 写入 mise.staging.tomlMISE_ENVstaging 时加载mise use的--env local会写入mise.local.toml若已存在.mise.local.toml则保留之--env staging则写入mise.staging.toml后者在MISE_ENVstaging时加载——这是多环境配置的关键技巧。use命令的源码实现位于 src/cli/use.rs。2. Shell 与环境Shell and environmentmise activate打印用于在交互式 Shell 中激活 mise 的脚本bash/zsh/fish/pwsh 各有对应。mise deactivate打印在当前 Shell 会话中禁用 mise 的脚本。mise completion生成 Shell 补全仓库中已提供 completions/_mise、completions/mise.bash、completions/mise.fish、completions/mise.ps1 等成品。mise en基于当前配置构建的环境启动一个新 Shell。mise env打印当前配置的环境变量便于调试或供其他工具消费。mise exec在设置了指定工具的环境下执行命令如mise exec node20 -- node app.js源码见 src/cli/exec.rs。mise shell仅为当前 Shell 会话设置工具版本。mise set/mise unset在mise.toml中设置 / 移除环境变量如mise set NODE_ENVproduction。mise shell-alias/mise tool-alias管理 Shell 别名 / 工具版本别名。mise ssh打开 SSH 会话可选择借用只读的 GitHub 访问权限。Shell 激活是让进入目录即自动生效的关键。以mise.run安装为例在 Shell 配置中加入README.md# ~/.bashrc eval $(~/.local/bin/mise activate bash)# ~/.zshrc eval $(~/.local/bin/mise activate zsh)# ~/.config/fish/config.fish ~/.local/bin/mise activate fish | source激活后进入项目目录即可直接使用配置中的工具与环境变量。3. 任务与项目自动化Tasks and project automationmise run运行任务及其依赖是任务系统的核心入口mise run build。mise tasks管理任务列出、执行等mise tasks ls可发现项目声明的全部任务。mise watch运行任务并在文件变化时自动重跑mise watch build。mise deps【实验性】管理项目依赖。mise generate为各种工具/服务生成文件。任务与工具的声明示例如下来自 README.md 的 Quickstart[tools] node 24 [env] NODE_ENV development [tasks.hello] description Print the projects Node.js version and environment run node -e console.log(process.version, process.env.NODE_ENV)mise run hello执行mise run hello时mise 会先按需安装node工具、加载NODE_ENV环境变量再运行任务——工具、环境、任务三者在一次调用中无缝协作。4. 机器初始化与镜像Machine setup and imagesmise bootstrap根据当前配置初始化一台机器含系统包、dotfiles、服务等对应 usage 规范中的[bootstrap.packages]、[bootstrap.dotfiles]、[bootstrap.services]等章节。mise oci【实验性】从mise.toml构建 OCI 容器镜像。这组命令把同一份mise.toml的声明能力延伸到新机器/新容器场景实现开发环境即代码。5. 配置与诊断Configuration and diagnosticsmise config管理配置文件mise config ls列出实际加载的配置文件。mise edit交互式编辑mise.toml。mise fmt格式化 mise TOML 配置。mise settings管理设置。mise trust/mise untrust将配置文件标记为受信任 / 移除显式信任。mise doctor检查 mise 安装与配置的潜在问题排查的首选命令。mise cache管理 mise 缓存。mise version显示 mise 版本。mise self-update更新 mise 自身。mise implode移除 mise CLI 及其全部相关数据彻底卸载。项目环境核查三连README.mdmise config ls # 看加载了哪些配置文件 mise ls --current # 看当前选中了哪些版本 mise exec -- node --version # 验证工具是否在项目环境中运行若mise exec -- node --version正常而直接运行node --version失败说明 Shell 激活有问题用mise doctor排查。6. 集成与社区Integrations and communitymise mcp在 stdin/stdout 上运行 Model Context Protocol 服务器为 AI 编码助手提供工具与任务上下文文档见 docs/mcp.md。mise skills活动工具从其 packslips 提供的 Agent skills。mise patrons/mise sponsors显示支持 mise 的个人 Patron 与赞助企业。7. 其他命令Other commandsmise plugins管理插件传统 asdf 风格插件的管理入口。mise test-tool测试工具能否正常安装与运行。mise token显示 mise 将使用的 git 提供商令牌。实战路线从零开始用命令驱动一个项目把命令家族串成一条完整工作流添加工具在项目目录执行mise use node20或mise use -g node20设置个人默认mise 自动安装并把请求写入mise.toml。声明环境与任务编辑mise.toml写入[env]与[tasks.xxx]或直接用mise set KEYvalue追加环境变量。一键复现mise install安装配置要求的全部工具mise run task运行任务mise watch task实现文件变更自动重跑。Shell 激活可选按上文在.bashrc/.zshrc/config.fish中加入mise activate进入目录即自动生效。可复现与排查用mise lock--locked固定下载 URL 与校验和mise doctor、mise config ls、mise ls --current核查配置与版本--no-config/--no-env/--no-hooks快速隔离问题来源。团队与 CI 同步提交mise.toml与 lockfile队友和 CI 用相同命令获得相同环境。小结mise的 CLI 设计围绕工具、环境变量、任务三件事展开命令参考文档docs/cli/index.md既是完整的功能地图也是与 mise.usage.kdl 和 src/cli 源码严格同步的权威接口说明。理解通用语法、全局 Flags 与七大命令族的定位即可用一套声明式配置和少量命令完成从个人开发、项目协作到机器初始化的全流程环境管理。需要某个命令的详细参数时直接查看 docs/cli 下对应的 Markdown 页面或运行mise COMMAND --help获取安装版本的实时帮助。【免费下载链接】misedev tools, env vars, task runner项目地址: https://gitcode.com/GitHub_Trending/mi/mise创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考