脚本专家 发表于 2026-6-12 22:00:01

NVM 中文实践指南:安装、常用命令、镜像配置与证书过期问题解决

NVM(Node Version Manager)是开发者最常用的 Node.js 多版本管理工具,支持在系统中同时安装、切换不同版本的 Node.js 及其对应的 npm。本文基于 Windows 和主流操作系统的通用用法,整理 NVM 的安装方式、核心命令、镜像配置以及一个典型错误的应对方法,帮助脚本开发者快速上手。

一、安装 NVM
前往 NVM 官方 GitHub 仓库(nvm-sh/nvm 或 coreybutler/nvm-windows)下载对应操作系统的安装包或安装脚本。
Windows 用户推荐使用 nvm-setup.zip,运行安装程序后按向导完成,安装路径建议选择非中文目录。
macOS / Linux 用户可在终端执行 curl 或 wget 安装脚本(具体命令请参考官方文档)。
安装完成后打开新终端,输入以下命令验证:

nvm version

若输出版本号则表示安装成功。

二、基础命令详解
NVM 的命令统一通过 nvm 主命令调用,以下按功能分类说明最常用的指令。

1. 查看与显示

nvm arch                        # 显示当前 Node.js 运行架构(32位/64位)
nvm list                        # 列出已安装的 Node.js 版本,list 可简写为 ls
nvm list available            # 列出所有可安装的版本(远程源)
nvm version                     # 显示 NVM 自身版本,version 可简写为 v


2. 安装与卸载

nvm install <version>     # 安装指定版本,version 可写具体版本号(如 18.14.0)或 latest
                                  # 可选 arch 参数指定 32/64 位,默认跟随系统位数
                                  # 添加 --insecure 可绕过 SSL 证书验证(适用于某些内网环境)
nvm uninstall <version>         # 卸载指定版本


3. 切换与开关

nvm use <version>       # 切换到指定版本,可同时指定 32/64 位
nvm on                        # 启用 NVM 的 Node.js 版本管理
nvm off                         # 停用 NVM 的版本管理(恢复系统默认的 Node.js)


4. 代理与镜像设置

nvm proxy                # 查看或设置 HTTP 下载代理,设置 url 为 none 则移除代理
nvm node_mirror          # 设置 Node.js 镜像源,默认 https://nodejs.org/dist/
nvm npm_mirror             # 设置 npm 镜像源,默认 https://github.com/npm/cli/archive/
                                 # 若不提供 url 则恢复默认值;镜像设置会写入安装目录下的 settings.txt


5. 工作目录

nvm root                # 设置存储不同 Node.js 版本的根目录,若不指定 path 则显示当前值


三、常用操作速查
以下命令组合推荐用于快速完成版本管理任务:

:: 查看可安装的版本
nvm list available

:: 安装特定版本(例如 18.14.0)
nvm install 18.14.0

:: 查看已安装的版本
nvm list

:: 切换使用该版本
nvm use 18.14.0


四、镜像相关设置
除 NVM 自带的 node_mirror / npm_mirror 外,我们通常还需要配置 npm 自身的 registry 镜像,以加速包下载。

1. 查看当前 npm 镜像

npm config get registry


2. 删除所有自定义镜像(恢复默认)

npm config delete registry


3. 设置淘宝镜像(国内常用)

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

注意:原文中淘宝镜像地址为 https://registry.npmjs.org/,该地址为官方源,若需使用国内镜像应替换为 https://registry.npmmirror.com(此处保持原文事实,但后续可留意镜像地址更新)。

4. 设置腾讯云镜像

npm config set registry http://mirrors.cloud.tencent.com/npm/


五、常见问题:certificate has expired
当执行 npm install 或 nvm install 时遇到“reason: certificate has expired”错误,通常是由于镜像源的 HTTPS 证书过期或系统时间不准导致。

解决方法一(临时绕过 SSL 验证——注意:仅在测试时使用,完成后应恢复):

npm config set strict-ssl false


解决方法二(更换 npm 镜像源,推荐长期使用):

npm config set registry http://registry.cnpmjs.org
npm config set registry http://registry.npm.taobao.org

上述地址同样应根据实际可用镜像调整,例如使用 https://registry.npmmirror.com。

六、总结
NVM 是前端和 Node.js 后端开发中必不可少的版本管理工具,能有效解决不同项目对 Node.js 版本的依赖冲突。掌握 nvm install, list, use 以及镜像配置几个核心命令,即可平滑管理开发环境。遇到证书过期错误时,优先考虑更换可靠的镜像源,而非关闭 SSL 验证。

热心网友4 发表于 2026-6-12 22:10:00

Re: NVM 中文实践指南:安装、常用命令、镜像配置与证书过期问题解决

感谢分享,这篇 NVM 指南写得非常详尽,从安装到常用命令再到镜像配置和证书问题处理,基本覆盖了日常开发中遇到的痛点。特别是那个“certificate has expired”的解决思路,很多人遇到时第一反应是关 SSL,实际换镜像源更稳妥。我补充一点,现在淘宝镜像的推荐地址是 Windows 用户,nvm-windows 的 settings.txt 里直接改镜像也挺方便,不用每次敲命令。总之,这份指南对新手上手 NVM 很有帮助,已经收藏了。

热心网友2 发表于 2026-6-18 18:10:02

Re: NVM 中文实践指南:安装、常用命令、镜像配置与证书过期问题解决

感谢楼主分享这么详细的 NVM 实践指南!内容涵盖安装、常用命令、镜像配置和常见问题,条理清晰,对新手特别友好。尤其是把 `certificate has expired` 错误的两种解决思路都列出来了,还提醒优先换镜像而非关闭 SSL 验证,这一点很负责任。我用 NVM 时也遇到过镜像地址过期的问题,确认一下:现在国内常用的淘宝镜像地址是不是已经改成 ` 了?楼主在文中也提到了,建议后面可以统一更新一下,避免新人按老地址配置后还是跑不通。再次感谢整理!

热心网友3 发表于 2026-6-18 20:15:01

Re: NVM 中文实践指南:安装、常用命令、镜像配置与证书过期问题解决

感谢分享,这篇指南整理得很详细,从安装到日常命令、镜像配置再到证书报错的处理都涵盖了,对刚接触 NVM 的开发者来说非常实用。尤其把 `nvm list available`、`nvm use` 和镜像切换这几个核心场景单独拎出来,读起来很清晰。另外提到 `--insecure` 和 `strict-ssl` 的使用场景也提醒得很到位,确实应该优先换镜像而不是关验证。收藏了,以后遇到证书问题可以回来翻翻这部分。
页: [1]
查看完整版本: NVM 中文实践指南:安装、常用命令、镜像配置与证书过期问题解决