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
-
安装方式:通过安装包手动安装。
-
步骤:
- 下载安装包:nvm-windows 最新版。
- 双击安装,路径不要包含空格或中文(默认路径:
C:\Users<用户名>\AppData\Roaming\nvm
)。 - 安装时自动配置环境变量。
-
验证安装:
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/Linux | Windows |
---|---|---|
权限错误 | 避免使用 sudo ,确保用户目录权限 | 以管理员身份运行终端 |
安装路径问题 | 默认在用户目录(~/.nvm ) | 路径不要有空格(如 Program Files ) |
命令未找到 | 检查 Shell 配置文件是否生效 | 确保安装时勾选“添加环境变量” |
版本切换不生效 | 重启终端或 source 配置文件 | 关闭终端后重新打开 |
6. 验证安装
# macOS/Linux 或 Windows(需安装后重启终端)
node -v # 显示 Node.js 版本
npm -v # 显示 npm 版本
总结
- macOS/Linux:通过脚本安装,依赖 Shell 配置,命令更灵活。
- Windows:需手动安装
nvm-windows
,路径和权限需特别注意。