Node.js 的版本管理对于开发者来说非常重要。通过 NVM(Node Version Manager),我们可以方便地管理多个版本的 Node.js,随时切换版本,避免兼容性问题。本文将带你一步步完成从卸载旧版本 Node.js 到安装 NVM、Node.js、NPM、CNPM、Yarn 及配置环境变量的详细教程。
一、卸载旧版本 Node.js
在安装 NVM 之前,如果你已经安装了 Node.js,请先卸载它,以避免版本冲突。
-
Windows:
-
打开“控制面板” -> “程序” -> “卸载程序”。
-
找到 Node.js,右键选择卸载。
-
卸载完成后,打开命令行并输入以下命令,确认 Node.js 是否已卸载:
node -v
若返回
node
相关的提示,说明还未卸载干净。需要手动删除C:\Program Files\nodejs
文件夹,并将环境变量中的路径也移除。 -
-
macOS 和 Linux:
如果 Node.js 是通过包管理器安装的,可以用以下命令卸载:
sudo apt-get remove nodejs # Ubuntu brew uninstall node # macOS (Homebrew)
-
检查是否卸载成功
node -v npm -v
如果返回
command not found
,则说明卸载成功。
二、安装 NVM
1. Windows 安装 NVM
Windows 下的 NVM 官方不直接支持,可以使用社区版本:nvm-windows。以下是详细步骤:
-
下载 NVM for Windows 的安装包:下载地址。
-
双击运行安装包,选择安装目录(建议安装在
C:\nvm
,Node.js 会默认安装在C:\nvm\nodejs
)。 -
安装完成后,打开命令行窗口,输入以下命令确认安装成功:
nvm -v
2. macOS 和 Linux 安装 NVM
在 macOS 和 Linux 系统上,可以直接使用 curl
安装 NVM。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
安装完成后,重新加载 shell:
source ~/.bashrc # 如果使用 bash
source ~/.zshrc # 如果使用 zsh
验证 NVM 安装:
nvm -v
三、使用 NVM 安装 Node.js
NVM 安装完成后,我们可以使用它来安装任意版本的 Node.js。
1. 安装特定版本的 Node.js
例如,安装 Node.js 16:
nvm install 16
安装成功后,NVM 会自动使用此版本。可以使用以下命令验证安装:
node -v
npm -v
2. 切换 Node.js 版本
如果已经安装了多个版本的 Node.js,可以随时使用 nvm use
来切换版本:
nvm install 14 # 安装 Node.js 14
nvm use 14 # 使用 Node.js 14
nvm use 16 # 切换回 Node.js 16
查看已安装的 Node.js 版本:
nvm list
3. 设置默认版本
如果希望系统默认使用特定版本的 Node.js,可以使用以下命令:
nvm alias default 16 # 设置默认使用 Node.js 16
四、安装 NPM、CNPM、Yarn
NVM 安装 Node.js 时,会自动安装 NPM。我们还可以选择安装 CNPM 和 Yarn,来管理我们的 JavaScript 包。
1. NPM(Node Package Manager)
NPM 是 Node.js 默认的包管理器,使用以下命令来检查 NPM 版本:
npm -v
2. CNPM(国内镜像)
由于网络原因,国内使用 NPM 可能较慢。可以安装 CNPM(淘宝 NPM 镜像)加速下载。
安装 CNPM:
npm install -g cnpm --registry=https://registry.npm.taobao.org
使用 CNPM:
cnpm install <package_name>
3. Yarn
Yarn 是另一个快速、可靠、安全的包管理工具。使用以下命令安装 Yarn:
npm install -g yarn
验证 Yarn 安装:
yarn -v
4. 切换国内 Yarn 镜像
同样可以为 Yarn 配置淘宝镜像,以提高下载速度:
yarn config set registry https://registry.npm.taobao.org
验证镜像地址:
yarn config get registry
# 输出 https://registry.npm.taobao.org 则表示配置成功
五、环境变量配置
在安装过程中,NVM 已经将 Node.js 的路径动态加入到系统 PATH 中,无需手动设置。但可以确保环境变量配置正确,以避免问题。
1. 确认 NVM_HOME
和 NVM_SYMLINK
变量
-
Windows:如果安装时选择了默认路径,应看到以下两个环境变量:
NVM_HOME
:例如C:\nvm
NVM_SYMLINK
:例如C:\nvm\nodejs
确保这两个变量在系统环境变量中已添加到
PATH
。 -
macOS 和 Linux:通过编辑
.bashrc
或.zshrc
文件,添加 NVM 环境变量:export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
2. 检查 Node.js 和 NPM 路径
在终端中输入以下命令检查路径:
which node
which npm
确保输出的路径是 NVM 安装的 Node.js 路径(Windows 默认在 C:\nvm\nodejs
下,Linux 默认在 ~/.nvm
中)。
六、常见问题及解决
1. NVM 命令找不到
Windows:可能是环境变量未配置正确。确保 NVM_HOME
和 NVM_SYMLINK
都在 PATH
中。
macOS 和 Linux:重新加载 .bashrc
或 .zshrc
,确保 nvm
命令已激活。
source ~/.bashrc
# 或
source ~/.zshrc
2. 无法安装指定的 Node.js 版本
有时候可能由于网络问题,导致安装失败。可以尝试以下命令使用淘宝镜像安装:
nvm install <version> --registry=https://registry.npm.taobao.org
七、使用示例
最后,测试安装是否成功。使用以下命令新建一个测试文件 app.js
,编写简单的 Node.js 代码进行测试:
echo "console.log('Node.js is working!');" > app.js
node app.js
# 输出:Node.js is working!
至此,我们已经完成了从卸载旧版本 Node.js 到安装 NVM、Node.js、NPM、CNPM、Yarn 及配置环境变量的全部内容。