查看: 143|回复: 1

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

[复制链接]
发表于 1 小时前 | 显示全部楼层 |阅读模式
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 安装脚本(具体命令请参考官方文档)。
安装完成后打开新终端,输入以下命令验证:
  1. nvm version
复制代码
若输出版本号则表示安装成功。

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

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

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

3. 切换与开关
  1. nvm use <version> [arch]        # 切换到指定版本,可同时指定 32/64 位
  2. nvm on                          # 启用 NVM 的 Node.js 版本管理
  3. nvm off                         # 停用 NVM 的版本管理(恢复系统默认的 Node.js)
复制代码

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

5. 工作目录
  1. nvm root [path]                 # 设置存储不同 Node.js 版本的根目录,若不指定 path 则显示当前值
复制代码

三、常用操作速查
以下命令组合推荐用于快速完成版本管理任务:
  1. :: 查看可安装的版本
  2. nvm list available
  3. :: 安装特定版本(例如 18.14.0)
  4. nvm install 18.14.0
  5. :: 查看已安装的版本
  6. nvm list
  7. :: 切换使用该版本
  8. nvm use 18.14.0
复制代码

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

1. 查看当前 npm 镜像
  1. npm config get registry
复制代码

2. 删除所有自定义镜像(恢复默认)
  1. npm config delete registry
复制代码

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

4. 设置腾讯云镜像
  1. npm config set registry http://mirrors.cloud.tencent.com/npm/
复制代码

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

解决方法一(临时绕过 SSL 验证——注意:仅在测试时使用,完成后应恢复):
  1. npm config set strict-ssl false
复制代码

解决方法二(更换 npm 镜像源,推荐长期使用):
  1. npm config set registry http://registry.cnpmjs.org
  2. npm config set registry http://registry.npm.taobao.org
复制代码
上述地址同样应根据实际可用镜像调整,例如使用 https://registry.npmmirror.com。

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

使用道具 举报

发表于 1 小时前 | 显示全部楼层

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

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

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-6-12 23:55 , Processed in 0.027192 second(s), 18 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部