NVM安装详细教程(卸载旧的Node.js,安装NVM、Node、NPM、CNPM、Yarn及环境变量配置)

Node.js 的版本管理对于开发者来说非常重要。通过 NVM(Node Version Manager),我们可以方便地管理多个版本的 Node.js,随时切换版本,避免兼容性问题。本文将带你一步步完成从卸载旧版本 Node.js 到安装 NVM、Node.js、NPM、CNPM、Yarn 及配置环境变量的详细教程。

一、卸载旧版本 Node.js

在安装 NVM 之前,如果你已经安装了 Node.js,请先卸载它,以避免版本冲突。

  1. Windows:

    • 打开“控制面板” -> “程序” -> “卸载程序”。

    • 找到 Node.js,右键选择卸载。

    • 卸载完成后,打开命令行并输入以下命令,确认 Node.js 是否已卸载:

      node -v
      

    若返回 node 相关的提示,说明还未卸载干净。需要手动删除 C:\Program Files\nodejs 文件夹,并将环境变量中的路径也移除。

  2. macOS 和 Linux:

    如果 Node.js 是通过包管理器安装的,可以用以下命令卸载:

    sudo apt-get remove nodejs # Ubuntu
    brew uninstall node         # macOS (Homebrew)
    
  3. 检查是否卸载成功

    node -v
    npm -v
    

    如果返回 command not found,则说明卸载成功。

二、安装 NVM

1. Windows 安装 NVM

Windows 下的 NVM 官方不直接支持,可以使用社区版本:nvm-windows。以下是详细步骤:

  1. 下载 NVM for Windows 的安装包:下载地址

  2. 双击运行安装包,选择安装目录(建议安装在 C:\nvm,Node.js 会默认安装在 C:\nvm\nodejs)。

  3. 安装完成后,打开命令行窗口,输入以下命令确认安装成功:

    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_HOMENVM_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_HOMENVM_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 及配置环境变量的全部内容。

猜你喜欢

转载自blog.csdn.net/qq_42978535/article/details/143573367