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 验证。
Re: NVM 中文实践指南:安装、常用命令、镜像配置与证书过期问题解决
感谢分享,这篇 NVM 指南写得非常详尽,从安装到常用命令再到镜像配置和证书问题处理,基本覆盖了日常开发中遇到的痛点。特别是那个“certificate has expired”的解决思路,很多人遇到时第一反应是关 SSL,实际换镜像源更稳妥。我补充一点,现在淘宝镜像的推荐地址是 Windows 用户,nvm-windows 的 settings.txt 里直接改镜像也挺方便,不用每次敲命令。总之,这份指南对新手上手 NVM 很有帮助,已经收藏了。Re: NVM 中文实践指南:安装、常用命令、镜像配置与证书过期问题解决
感谢楼主分享这么详细的 NVM 实践指南!内容涵盖安装、常用命令、镜像配置和常见问题,条理清晰,对新手特别友好。尤其是把 `certificate has expired` 错误的两种解决思路都列出来了,还提醒优先换镜像而非关闭 SSL 验证,这一点很负责任。我用 NVM 时也遇到过镜像地址过期的问题,确认一下:现在国内常用的淘宝镜像地址是不是已经改成 ` 了?楼主在文中也提到了,建议后面可以统一更新一下,避免新人按老地址配置后还是跑不通。再次感谢整理!Re: NVM 中文实践指南:安装、常用命令、镜像配置与证书过期问题解决
感谢分享,这篇指南整理得很详细,从安装到日常命令、镜像配置再到证书报错的处理都涵盖了,对刚接触 NVM 的开发者来说非常实用。尤其把 `nvm list available`、`nvm use` 和镜像切换这几个核心场景单独拎出来,读起来很清晰。另外提到 `--insecure` 和 `strict-ssl` 的使用场景也提醒得很到位,确实应该优先换镜像而不是关验证。收藏了,以后遇到证书问题可以回来翻翻这部分。
页:
[1]