nvs

发表于 更新于 分类于 本文字数： 1.4k 阅读时长 ≈ 1 分钟

NVS 简介

NVS (Node Version Switcher) 是一个跨平台的 Node.js 版本管理工具，支持 Windows、macOS 和 Linux 系统。主要功能包括：

  • 多版本 Node.js 安装和管理

  • 自动切换项目指定版本

  • 轻量级且无依赖

  • 支持所有主流 shell 环境

安装 NVS

1. 从 GitHub 下载 msi 安装包

2. 通过 winget 安装

在命令提示符或 PowerShell 中运行以下命令：

1
winget install jasongin.nvs

3. 通过 Chocolatey 安装

如果你已经安装了 Chocolatey 包管理器，可以运行以下命令：

1
choco install nvs

配置环境变量

1. Git Bash

  • 在 Git 安装目录下找到或新建 .bash_profile 文件，添加以下代码：

    1
    if [ -f ~/.bashrc ]; then . ~/.bashrc; fi

  • 在 .bashrc 文件中添加：

    1
    2
    export NVS_HOME=$LOCALAPPDATA/nvs
    . $NVS_HOME/nvs.sh

2. CMD

运行以下命令：

1
2
set NVS_HOME=%LOCALAPPDATA%\nvs
"%NVS_HOME%\nvs.cmd" install

3. PowerShell

运行以下命令：

1
2
$env:NVS_HOME="$env:LOCALAPPDATA\nvs"
. "$env:NVS_HOME\nvs.ps1" install

使用 nvs 管理 Node.js 版本

1. 安装特定版本的 Node.js

在命令行中运行以下命令：

1
nvs add <version>

例如，安装 Node.js 22.11.0 版本：

1
nvs add 22.11.0

2. 切换到特定版本的 Node.js

运行以下命令：

1
nvs use <version>

3. 查看已安装的 Node.js 版本

运行以下命令：

1
nvs ls

4. 设置默认 Node.js 版本

运行以下命令：

1
nvs link <version>

每次打开终端时都会自动使用该版本。

进阶配置

1. 配置 npm 全局模块安装路径

为避免切换 Node.js 版本后重新安装全局模块，可以配置统一的全局模块安装路径：

1
2
3
4
5
6
7
8
9
# 创建全局模块目录
mkdir -p ~/.npm-global

# 设置npm使用该目录
npm config set prefix ~/.npm-global

# 将该目录添加到PATH环境变量
echo "export PATH=~/.npm-global/bin:$PATH" >> ~/.zshrc
source ~/.zshrc

实用技巧

1. 自动切换项目 Node 版本

在项目根目录创建 .node-version 文件，写入需要的版本号：

1
echo "16.14.0" > .node-version

nvs 会自动检测并使用该版本。

2. 查看远程可用版本

1
nvs remote

3. 删除指定版本

1
nvs rm 14.17.0

常见问题

1. 安装失败怎么办？

  • 确保有管理员权限

  • 检查网络连接

  • 尝试使用 --verbose 参数查看详细日志

2. 版本切换不生效？

  • 检查当前 shell 类型

  • 确保已正确配置环境变量

  • 重启终端尝试

参考资源