NVM Desktop：Node.js 版本管理桌面应用

项目简介

NVM Desktop 是一款用于在 macOS、Windows 和 Linux 上管理多个 Node.js 版本的桌面应用。它把图形界面和配套的 nvmd 命令行工具结合起来：既能在应用里浏览、安装、切换版本，也能在终端里用 nvmd 完成同样的操作。适合经常在老旧服务、新项目和一批相关仓库之间来回切换运行时的开发者。

应用本身使用 Tauri、Rust、React、TypeScript、Tailwind CSS 和 Base UI 构建。

主要功能

• 版本管理：浏览发行版、选择架构、安装与卸载 Node.js。
• 全局默认版本：在 Installed 页面把某个已安装版本设为全局默认。
• 项目级版本：为指定项目文件夹单独分配 Node.js 版本，不必改动全局默认。
• 项目组：把相关项目编成一组共用同一版本，在组里改一次即可同步到所有成员；每个项目最多属于一个组。
• 版本文件：项目版本写入版本文件，默认文件名 .nvmdrc，可在设置中改为 .nvmrc、.node-version 等；当前目录配置的版本文件优先于全局默认。
• 图形界面与 CLI 并存：nvmd 提供安装、切换、查看、卸载、定位可执行文件等命令。
• 外观定制：浅色、深色、跟随系统三种模式，支持基础色、强调色、完整主题和圆角调整。
• 配置项：可自定义镜像、代理、项目默认值，并支持配置导入导出。

安装与使用

1. 安装桌面应用

从 GitHub Releases 下载对应操作系统与架构的安装包，安装并启动。首次启动的引导会带你完成 shell 配置和第一个运行时的安装。

2. 连接终端

macOS 和 Linux 在 shell 启动文件（如 Zsh 的 ~/.zshrc、Bash 的 ~/.bashrc）中加入：

export NVMD_DIR="$HOME/.nvmd"
export PATH="$NVMD_DIR/bin:$PATH"

保存后打开新终端。

Windows 确认用户 PATH 中包含 %USERPROFILE%\.nvmd\bin，然后打开新终端。

用以下命令确认命令行工具可用：

nvmd --version

3. 安装并选择 Node.js

在 Versions 中选择发行版与架构并安装，再到 Installed 中把已安装版本设为全局默认。也可以在终端操作（版本号请换成你需要的）：

nvmd install 20.18.0
nvmd use 20.18.0
node --version

4. 为项目指定版本

在 Projects 中添加项目文件夹并选择已安装的 Node.js 版本，然后在项目目录中运行 node --version 验证。也可以直接在项目目录执行：

nvmd use 20.18.0 --project

常用命令：nvmd list、nvmd current、nvmd uninstall 20.18.0、nvmd which node、nvmd --help。在终端切换版本后，需要刷新应用中的对应页面才能显示最新信息。

注意事项

• 修改 PATH 后必须打开新终端；nvmd 的 bin 目录要排在其他 Node.js 安装之前，可用 nvmd which node 与 which node（Windows 为 where.exe node）对照。
• 项目版本与全局默认不一致时，通常是当前目录的版本文件生效；请检查项目分配的版本、所属组以及设置中的版本文件名。
• 全局 npm 包默认按 Node.js 版本隔离。若确需共享，可用 npm config set prefix "/path/to/shared-global" 并确保该路径在 PATH 中。
• 项目文件夹必须存在且可写，应用才能更新其版本文件。
• 默认数据目录：macOS/Linux 为 ~/.nvmd，Windows 为 %USERPROFILE%\.nvmd；桌面应用支持用 NVMD_HOME 覆盖数据目录，运行时安装目录可在设置中修改。
• 配置导出不包含已安装的 Node.js 运行时和项目源码，不能当作备份使用。

本作品整理自 GitHub 开源项目 1111mp/nvm-desktop，原作者 @1111mp，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。