用途:mise 用于统一管理工具链版本、环境变量与项目任务,并支持可复现的 CI 构建。本资料是一份操作指南,帮助按意图选择正确的 mise 选项与命令。
主要能力与流程:先识别意图,分为工具版本与运行时、项目或 shell 环境变量、构建/测试/部署命令、可复现 CI 构建、以及“command not found”或 PATH 不匹配的排查五类路径。修改前先检测现状,查看配置文件与信任状态: ls -la mise.toml .mise.toml mise.local.toml .tool-versions 2>/dev/null mise config mise doctor
配置范围:团队共享且提交的默认值用 mise.toml;个人或本机覆盖(通常加入 gitignore)用 mise.local.toml;用户级默认值用 ~/.config/mise/config.toml。需要所有贡献者共享的改动用 mise.toml,个人或机器相关的用 mise.local.toml 或全局配置。
常用命令:优先用 CLI 而非手工编辑,例如添加或更新项目工具 mise use node@20;添加全局默认 mise use -g python@3.12;安装配置中声明的工具 mise install;不完整激活 shell 的一次性执行 mise exec -- node -v;带 mise 上下文(工具与环境)运行任务 mise run <task>。
验证与排查:编辑后运行 mise doctor、mise ls --current、mise which <tool> 及 <tool> --version。若 mise which <tool> 与 shell 的 which/where 不一致,应排查激活或 PATH 配置。
决策要点:交互式 shell 用激活,shell 初始化受限的 CI 或 IDE 场景可用 shims;工具增改优先用 mise use;mise exec 用于一次性或 CI 执行,不应作为激活损坏的长期替代;锁定策略为配置中使用宽松版本并配合 lockfile 保证可复现。
限制:资料未提供具体安装方式、支持平台、收费与价格信息,暂未提供。