什么是 NVM?

NVM(Node Version Manager)是一个工具,用于管理和切换不同版本的 Node.js。在开发过程中,我们可能会遇到不同项目依赖不同版本 Node.js 的情况,NVM 提供了一个便捷的解决方案。它不仅可以帮助你安装和卸载 Node.js 版本,还可以轻松切换版本,避免不同版本间的兼容性问题。

一、安装与配置 NVM

1. 下载 NVM 安装包

首先,你需要下载 NVM 的安装包。你可以前往 官方仓库 下载最新版本的安装包,

或者直接点击以下链接下载 v1.1.12 版本:nvm-setup-v1.1.12版本安装包下载

image-20241203020838897

2. 安装 NVM

  1. 双击运行下载的安装包。

image-20241203094018747

  1. 在弹出的安装界面中,选择接受许可协议并点击 “Next”。

1733163655051.png

  1. 选择自定义的安装路径,建议自定义路径以便管理。(我这里是自定义的安装路径)

1733191400046.png

  1. 设置 Node.js 的安装路径,也可以自定义此路径。(我这里是自定义的安装路径)

image-20241203100827950

  1. 点击 “Install” 完成安装

image-20241203101114101

3.验证 NVM 安装是否成功

打开命令行工具(CMD),运行以下命令来检查 NVM 是否安装成功:

  1. # 查看 nvm 版本
  2. nvm version
  3. # 查看系统架构(32位或64位)
  4. nvm arch
  5. # 查看已安装的 Node 版本
  6. nvm list
  7. # 查看可用的 Node 版本
  8. nvm list available
  9. # 卸载指定版本
  10. nvm uninstall [version]
  11. # 切换到指定版本
  12. nvm use [version]

image-20241203102329248

4. 配置国内下载源(可选)

为了提高 NVM 安装和更新的速度,建议配置国内镜像源。你可以编辑 NVM 安装目录下的 settings.txt 文件,添加以下两行:

  1. node_mirror: https://npmmirror.com/mirrors/node/
  2. npm_mirror: https://npmmirror.com/mirrors/npm/

image-20241203113909341

二、安装和切换 Node.js 版本

1. 安装 Node.js 版本

使用 NVM 安装指定版本的 Node.js。首先查看可用的 Node.js 版本:

  1. nvm list available

然后,安装所需版本(例如,安装 22.11.0

  1. nvm install 22.11.0

切换到已安装的版本

  1. nvm use 22.11.0

image-20241203113242403

2. 配置 NPM 镜像源

为了加速 npm 包的下载,可以将 npm 的镜像源设置为国内源。以下是常见的镜像源配置:

  • 淘宝镜像源:

  1. npm config set registry https://registry.npmmirror.com
  • 腾讯云镜像源:

  1. npm config set registry https://mirrors.cloud.tencent.com/npm/
  • 华为云镜像源:

  1. npm config set registry https://mirrors.huaweicloud.com/repository/npm/
  • 恢复官方镜像源:

  1. npm config set registry https://registry.npmjs.org/

查看当前镜像源:

  1. npm config get registry

3. 配置 NPM 全局缓存和依赖路径

你可以自定义 NPM 的缓存和全局依赖路径。首先查看当前设置:

  1. npm config get cache
  2. npm config get prefix

然后,修改配置缓存和全局依赖路径(这里为自定义路径,自行修改为自己对应的路径)

  1. npm config set prefix "D:\tools\nodejs\node_global"
  2. npm config set cache "D:\tools\nodejs\node_cache"

4. 配置环境变量

  1. 新建 NODE_PATH 环境变量:

    • 打开系统属性,右键点击“此电脑”或“我的电脑”,选择“属性”。

    • 点击“高级系统设置” -> “环境变量”。

    • 在“用户变量”部分,点击“新建”。

    • 设置变量名为 NODE_PATH,变量值为 D:\tools\nodejs\node_global\node_modules(请替换为实际路径)。

    image-20241203162214484

  2. 编辑 Path 环境变量:

    • 添加 %NVM_HOME% 和 %NVM_SYMLINK%,如果已存在 C:\Users\用户名\AppData\Roaming\npm,修改为 D:\tools\nodejs\node_global\node_modules

    image-20241203163320950

  3. 测试是否成功: 运行以下命令安装一个全局包:

  1. npm install express -g

查看是否生成 express 文件夹。

image-20241203163835305

三、常用命令

  1. ## 查看已经安装的版本
  2. nvm list
  3. ## 查看已经安装的版本
  4. nvm list installed
  5. ## 查看网络可以安装的版本
  6. nvm list available
  7. ## 查看当前的版本
  8. nvm version
  9. ## 安装最新版本
  10. nvm install
  11. ## 切换使用指定的版本
  12. nvm nvm use <version>
  13. ## 列出所有版本
  14. node nvm ls
  15. ## 显示当前版本
  16. nvm current
  17. ## 给不同的版本号添加别名
  18. nvm alias <name> <version>
  19. ## 删除已定义的别名
  20. nvm unalias <name>
  21. ## 在当前版本node环境下,重新全局安装指定版本号的npm包
  22. nvm reinstall-packages <version>
  23. 打开nodejs控制
  24. nvm on
  25. 关闭nodejs控制
  26. nvm off
  27. 查看设置与代理
  28. nvm proxy
  29. 设置或者查看setting.txt中的node_mirror,如果不设置的默认是 Index of /dist/
  30. nvm node_mirror [url]
  31. 设置或者查看setting.txt中的 npm_mirror,如果不设置的话默认的是: https://github.com/npm/npm/archive/
  32. nvm npm_mirror [url]
  33. 卸载制定的版本
  34. nvm uninstall <version>
  35. 切换制定的node版本和位数
  36. nvm use [version] [arch]
  37. 设置和查看root
  38. nvm root [path]