mise

现代多语言版本与环境管理器

补充说明

mise 管理多语言版本、环境变量和任务，兼容 asdf 插件。它能按目录自动切换版本，并用 mise.toml 描述项目配置。

常用示例

mise --version
mise use node@20
mise use python@3.12
mise install
mise ls
mise current
mise global node@20
mise local node@20
mise exec -- node --version
mise run build
mise activate zsh
mise trust
mise settings

mise.toml：

[tools]
node = "20"
python = "3.12"

[env]
NODE_ENV = "development"

[tasks.build]
run = "npm run build"

易错点与排错

• 需要先在 shell 配置里 mise activate；只安装不激活不会自动切换版本。
• 项目配置文件可能需要 mise trust 才会执行其中的任务和环境变量。
• shim 和 activate 是两种模式；不要和 asdf 的 shim 混用同一套命令。
• mise use 会修改配置文件；先确认写的是全局还是项目级。
• 插件兼容 asdf，但并非所有插件行为完全一致；迁移前验证。
• 环境变量优先级和 shell 已有变量有关；排查时用 mise env 看实际值。
• 版本下载依赖网络和系统依赖；CI 里要缓存工具安装目录。
• 任务执行环境和交互 shell 可能不同；路径和变量要显式声明。

相关命令

• asdf — 传统多语言版本管理
• nvm / pyenv / rbenv — 单语言版本管理