使用nvm安装 Node.js

25 阅读2分钟

1. 安装 nvm

macOS/Linux

  • 安装方式:通过脚本安装(需终端操作)。

  • 步骤

    # 使用 curl 或 wget 安装
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    # 或
    wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    
  • 配置生效

    source ~/.bashrc   # 或 ~/.zshrc、~/.profile(取决于你的 Shell)
    
  • 验证安装

    nvm --version
    

Windows

  • 安装方式:通过安装包手动安装。

  • 步骤

    1. 下载安装包:nvm-windows 最新版
    2. 双击安装,路径不要包含空格或中文(默认路径:C:\Users<用户名>\AppData\Roaming\nvm)。
    3. 安装时自动配置环境变量。
  • 验证安装

    nvm version
    

2. 安装 Node.js

macOS/Linux

  • 命令通用性:直接使用 nvm install 命令。

  • 示例

    nvm install node      # 安装最新版
    nvm install --lts     # 安装最新 LTS 版
    nvm install 18.0.0    # 安装指定版本
    

Windows

  • 命令相同:语法与 macOS/Linux 一致,但需在管理员权限的终端运行。

  • 示例(PowerShell 或 CMD):

    nvm install latest    # 安装最新版
    nvm install lts       # 安装最新 LTS 版
    nvm install 18.0.0    # 安装指定版本
    

3. 切换 Node.js 版本

macOS/Linux

  • 直接切换

    nvm use 18.0.0
    
  • 设置默认版本

    nvm alias default 18.0.0
    

Windows

  • 需管理员权限

    nvm use 18.0.0
    
  • 设置默认版本

    nvm alias default 18.0.0
    

4. 镜像加速(国内用户)

macOS/Linux

  • 临时使用镜像

    NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node nvm install 18.0.0
    
  • 永久生效:将镜像添加到 Shell 配置文件(如 ~/.bashrc):

    export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
    

Windows

  • 临时使用镜像

    set NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
    nvm install 18.0.0
    
  • 永久生效:在系统环境变量中添加 NVM_NODEJS_ORG_MIRROR,值为镜像地址。


5. 常见问题

问题macOS/LinuxWindows
权限错误避免使用 sudo,确保用户目录权限以管理员身份运行终端
安装路径问题默认在用户目录(~/.nvm路径不要有空格(如 Program Files
命令未找到检查 Shell 配置文件是否生效确保安装时勾选“添加环境变量”
版本切换不生效重启终端或 source 配置文件关闭终端后重新打开

6. 验证安装

# macOS/Linux 或 Windows(需安装后重启终端)
node -v  # 显示 Node.js 版本
npm -v   # 显示 npm 版本

总结

  • macOS/Linux:通过脚本安装,依赖 Shell 配置,命令更灵活。
  • Windows:需手动安装 nvm-windows,路径和权限需特别注意。