一、如何完全卸载旧的 Node.js
建议使用系统自带卸载功能或第三方工具清理残留文件和注册表。
1.1 开始卸载
找到已安装的 Node.js 程序,右键点击卸载。第三方工具可深度清理残留。
二、安装 nvm
从 GitHub 官方仓库下载 nvm-windows 安装包。
2.1 开始下载
访问 Releases · coreybutler/nvm-windows,下载 nvm-setup.exe。
2.2 开始安装
双击安装包,按照向导完成安装。
三、配置 nvm
3.1 nvm 修改镜像源
找到 nvm 安装目录下的 setting.txt 文件,编辑以下内容:
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/
保存文件。
3.2 nvm 配置环境变量
打开系统环境变量设置,确认 NVM_HOME 和 NVM_SYMLINK 已存在。
在命令行输入 nvm -v 验证配置是否成功。
四、安装 Node.js
4.1 通过 nvm 安装 Node.js
4.1.1 查看最新版本号
nvm list available
4.1.2 安装指定版本
nvm install <版本号>
例如:nvm install 18.18.2
4.1.3 查看安装的所有版本
nvm list
4.1.4 切换需要的版本
nvm use <版本号>
4.1.5 查看 Node.js 版本
node -v
4.1.6 查看 npm 的版本
npm -v
4.2 Node.js 配置环境变量
4.2.1 配置全局安装的模块路径和缓存路径
在 nvm 安装目录下新建 node_global 和 node_cache 文件夹。
在 CMD 中输入以下命令(请根据实际路径修改):
npm config set prefix "F:\\Chengxusheji\\Nvm\\nvm\\node_cache"
npm config set cache "F:\\Chengxusheji\\Nvm\\nvm\\node_global"
4.2.2 设置用户变量
检查 Path 变量中是否包含 %NVM_HOME% 和 %NVM_SYMLINK%。
将原有的 AppData\Roaming\npm 路径修改为新建的 node_global 路径。
4.2.3 设置系统变量
Path 变量设置与用户变量一致。
4.2.4 设置缓存变量
新建环境变量 NODE_PATH,值为 F:\\Chengxusheji\\Nvm\\nvm\\node_global\\node_modules。
4.2.5 测试配置是否正确
尝试全局安装 Yarn:
npm install -g yarn
4.2.6 设置淘宝镜像并查看
npm config set registry https://registry.npmmirror.com/
npm config get registry
五、nvm 常用命令
| 命令 | 说明 |
|---|---|
nvm -v | 查看 nvm 当前版本 |
nvm list 或 nvm ls | 列出已安装的 Node.js 版本 |
nvm list available | 查看可安装的 Node.js 版本 |
nvm install <version> | 安装指定版本的 Node.js |
nvm use <version> | 临时切换到指定 Node.js 版本 |
nvm alias default <version> | 设置默认 Node.js 版本 |
nvm uninstall <version> | 卸载指定版本的 Node.js |
nvm current | 显示当前正在使用的 Node.js 版本 |
nvm root | 显示 nvm 的安装目录 |
六、nvm 无法自动下载低版本 npm 解决方法
若执行 nvm install <版本> 时 npm 下载失败,可手动下载对应版本的 Node.js 压缩包。
访问 npm 镜像站 查找对应文件。
解压并重命名为版本号文件夹,放入 nvm 安装目录下的 versions 文件夹中。
重新运行 nvm ls 即可识别该版本。

