用途:mise 管理开发工具版本、环境配置和项目任务,确保团队成员与 CI 使用一致的工具链,并可在工具链旁定义构建、测试、部署工作流。
主要能力:通过 mise.toml 声明项目所需工具链并提交到仓库;通过 mise.local.toml 保存个人工具偏好(按约定加入 gitignore);支持用户级默认配置 ~/.config/mise/config.toml;支持任务定义、构建运行、watch 模式、任务级工具依赖、monorepo 任务组织、GitHub Actions 与 lockfile 集成。
使用方式:克隆含 mise.toml 的项目后需手动运行 mise install 安装工具,该步骤不会自动执行。建议在 shell rc 文件中使用 mise activate 以获得完整功能,shims 可用但有限制(除工具调用外不会更新环境变量)。建议提交 mise.lock 以保证可复现性并避免限流问题。CI 为非交互环境,应使用 mise x -- command 或 shims,而非 mise activate。
配置选择:自己控制的仓库用 mise.toml 并提交;参与他人仓库用 mise.local.toml(gitignore);用户级默认用 ~/.config/mise/config.toml。
限制与注意:激活仅适用于 .bashrc/.zshrc,不适用于 .bash_profile;不要提交 mise.local.toml;CI 中缺少 GITHUB_TOKEN 可能触发 API 限流;usage 字段内容为 KDL 而非 TOML;task_templates 仅从根 mise.toml 解析;委派对象仅支持 task/tasks 键。
适用场景:团队统一工具链、CI 环境一致性、monorepo 任务编排、项目构建/测试/部署流程定义。