🛠️ mise 全方位上手指南：从安装到卸载

在日常开发中，你是否经常面临这样的崩溃瞬间：项目 A 需要 Node.js 16，项目 B 却强制要求 Node.js 20；换了一台电脑，Python 环境又要重新折腾半天；团队新成员入职，光是配环境就花了一整天……

如果你受够了这些繁琐的环境配置，那么全能开发环境管理器 mise 绝对能帮你彻底告别环境焦虑！

1. 介绍：什么是 mise？

mise（发音同 "mice"）是一款用 Rust 编写的高性能多运行时版本管理器。简单来说，它是一个集大成者，完美结合了以下三款工具的核心功能：

asdf：强大的多版本管理。
direnv：智能的环境变量管理。
make：便捷的任务运行器。

得益于 Rust 的高性能，mise 的执行速度极快，几乎感觉不到版本切换的延迟。通过简单的配置文件，就能将开发环境随代码一起提交到 Git，确保团队成员和 CI/CD 环境完全一致，彻底根治“在我机器上能跑”的玄学 Bug。

2. 能管理的环境

mise 背靠庞大的插件生态（完全兼容 asdf 插件），能管理的工具多达数百种。除了主流编程语言，它还能管理各种 CLI 命令行工具、云原生工具以及最新的 AI 编程助手。大致可以分为以下几类：

🔧 主流编程语言与运行时 Node.js（完美替代 nvm）、Python（完美替代 pyenv）、Go、Java（JDK、Maven、Gradle）、Rust、Ruby、PHP、Zig、Dart、Flutter 等。
☁️ 云原生与 DevOps 工具 Terraform、Docker、Kubernetes (kubectl)、AWS CLI、Helm、Packer 等。
🔗 区块链开发工具 Solidity 编译器、Hardhat、Truffle 等。
🤖 前沿 AI 编程助手 Claude Code、OpenCode 等。
🛠️ 其他实用 CLI 工具 Buf (Protobuf)、jq (JSON 处理)、cmake、ffmpeg 等。

3. 安装与激活

在 macOS、Linux 或 WSL 系统上，安装 mise 非常丝滑。推荐使用 Homebrew 或官方脚本进行安装：

# 使用 Homebrew 安装（推荐 macOS/Linux 用户）
brew install mise

# 或者使用官方一键脚本安装
curl https://mise.run | sh

⚠️ 关键步骤：激活 Shell 安装完成后，必须将其激活到你的 Shell 中，才能实现自动切换版本。

如果你使用的是 Zsh（macOS 默认终端）： echo 'eval "$(mise activate zsh)"' >> ~/.zshrc && source ~/.zshrc
如果你使用的是 Bash： echo 'eval "$(mise activate bash)"' >> ~/.bashrc && source ~/.bashrc

Windows 用户提示：推荐使用 Scoop 安装（scoop install mise），并在 PowerShell 配置文件中添加激活命令 mise activate pwsh | Out-String | Invoke-Expression。

4. 环境管理

mise 的强大之处在于它可以通过 mise.toml 配置文件或命令行，灵活地管理全局和本地的开发环境。

4.1 全局管理如果你希望某个工具在整台电脑上默认使用特定版本，可以使用全局（`-g`）命令。例如，设置全局默认的 Node.js 和 Python 版本：

mise use -g node@20
mise use -g python@3.12

这样设置后，无论你在哪个目录下，只要没有被本地配置覆盖，都会默认使用这些版本。

4.2 具体（项目级）管理在具体项目中，mise 会根据目录自动切换环境。你只需要在项目根目录创建一个 `mise.toml` 文件，声明该项目需要的工具、环境变量甚至任务：

[tools]
node = "20.11.0"
python = "3.12.0"
go = "1.22"

# 还可以顺便定义项目专属的环境变量
[env]
DATABASE_URL = "postgres://localhost/myapp_dev"
API_KEY = "dev-secret-key"

# 定义任务运行器（替代 Makefile / npm scripts）
[tasks]
dev = "npm run dev"
test = "pytest tests/"

保存文件后，当你进入该项目目录时，mise 会自动在后台为你安装并切换好对应的版本和环境变量；离开该目录后，环境会自动恢复，真正做到互不干扰。

5. 基本命令介绍

掌握以下几个核心命令，就能轻松驾驭 mise：

命令	说明
`mise ls-remote`	查看远端所有可安装的版本
`mise list` 或 `mise ls`	列出当前已安装的所有工具版本
`mise install`	安装 `mise.toml` 中声明的所有工具
`mise upgrade`	一键升级所有已安装的工具到最新版本
`mise outdated`	检查哪些工具已有新版本可供升级
`mise doctor`	排错必备，检查 mise 的安装状态和环境配置是否正常
`mise current`	查看当前目录下正在激活的版本
`mise uninstall <工具名>`	卸载指定的工具

6. 卸载指南

如果你决定不再使用 mise，可以按照以下步骤彻底清理：

清理 Shell 配置 打开你的 Shell 配置文件（如 ~/.zshrc 或 ~/.bashrc），删除包含 mise activate 的那一行代码，并保存退出。
删除 mise 程序及数据
- Homebrew 安装：直接执行 brew uninstall mise。
- 官方脚本安装：手动删除相关目录： rm -rf ~/.local/share/mise # 删除工具安装目录和数据 rm -rf ~/.config/mise # 删除配置文件 rm ~/.local/bin/mise # 删除 mise 可执行程序
清理环境变量（可选） 如果你在系统中手动设置过 MISE_DATA_DIR 等环境变量，记得在系统设置或 Shell 配置中将其删除。

希望这份指南能帮助你快速上手 mise，享受丝滑的开发环境管理体验！