nvm 速查表：Node.js 多版本安装、切换与镜像配置实战指南

文档知识库教程开发工具【免费下载链接】reference为开发人员分享快速参考备忘清单(速查表)项目地址https://gitcode.com/jaywcjlove/reference点击查看免费下载本文基于开源仓库 reference 的 nvm 备忘清单 整理而成聚焦 Node Version Managernvm这一多版本管理工具从 Windows / macOS / Linux 的安装方式到版本安装、切换、卸载、架构切换、代理与镜像配置等全部核心命令。读完本文你将能在一台电脑上自由安装与切换多个 Node.js 版本并为国内网络环境配置 node / npm 镜像加速。nvm 是什么nvmNode Version Manager是一个用于管理电脑上多个 Node.js 版本的程序。它解决的核心痛点是不同项目往往依赖不同版本的 Node.js例如旧项目要求 Node 16新项目需要 Node 20手动卸载重装不仅繁琐还容易破坏全局环境。nvm 让这些版本可以共存并允许随时切换当前生效的版本。在 reference 仓库中nvm 被归类在 Nodejs 分类下与 npm、pnpm、Yarn、Bun 等工具并列见 README.md是 Node.js 生态工具链的第一环。nvm 主要有两大发行版对应不同操作系统发行版适用平台说明nvm-sh / nvmmacOS、Linux 等 POSIX 兼容 Shell通过 Shell 脚本安装命令以nvm开头nvm-windowsWindows提供图形化安装程序命令同样以nvm开头内部又称 NVM4W本文备忘清单中绝大多数命令如nvm on/off、nvm root、nvm arch、nvm proxy、nvm node_mirror等以 nvm-windows 的交互方式为准安装方式则覆盖两个平台使用时请结合自己的操作系统对照。安装 nvmWindows 安装在 Windows 上获取最新的发行版安装程序对应项目为 nvm-windows。下载完成后双击setup程序按照提示操作即可完成安装。安装完成后建议重新打开一个终端窗口或重新登录确保nvm命令已进入 PATH。macOS / Linux 安装在 macOS 与 Linux 等 POSIX 兼容的 Shell 环境中官方推荐使用安装脚本一键安装。可以直接使用curlcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash也可以使用wgetwget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash两种方式效果等价脚本会拉取 nvm 源码并写入 Shell 配置如~/.bashrc、~/.zshrc此后打开新终端即可使用nvm命令。安装完成后建议先执行nvm --version或nvm version确认安装是否成功。快速使用安装完成后可以用一组命令快速验证环境是否就绪# 下载并安装 Node.js 20 版本 nvm install 20 # 验证环境中的 Node.js 版本是否正确 node --version # 应该打印v20.11.1 # 验证环境中是否存在正确的 NPM 版本 npm --version # 应该打印10.2.4执行顺序说明nvm install 20会自动下载并安装 Node.js 20.x 系列的最新版本并默认将其设为当前使用版本node --version用于确认node可执行文件确实指向新安装的版本对应 v20.11.1npm --version用于确认随 Node.js 一起安装的 npm 版本是否正确对应 10.2.4。这一步是排查命令找不到或版本仍是旧版等安装问题的标准手段。版本查看与安装展示当前使用版本nvm current输出当前 Shell 会话中正在使用的 Node.js 版本号是确认当前到底用的是哪个版本的最快方式。安装指定版本的 node 程序nvm install version [arch]version参数除了具体的版本号还支持两个特殊取值取值含义latest安装最新版本lts安装最近的 LTS长期支持版本arch参数用于指定安装位数取值含义32安装 32 位版本64安装 64 位版本all同时安装 32 位和 64 位版本省略默认跟随系统架构在命令最后添加--insecure将跳过远程下载服务器的 SSL 验证适用于下载服务器证书异常等特殊场景日常安装不建议使用。# 安装 Node.js 20 的 64 位版本 nvm install 20 64 # 安装最新 LTS 版本 nvm install lts # 同时安装 32 位与 64 位版本 nvm install 18 all切换使用指定版本nvm use version [arch]将当前生效的 Node.js 切换为指定版本arch同样可指定32/64位。切换后建议用node --version验证生效结果。补充说明nvm use只影响当前终端会话的生效版本如需让新开终端默认使用某个版本可以配合nvm alias default version等别名机制或在nvm install后保持默认版本设置。列出 node.js 已安版本nvm list [available]不带参数时列出本机已安装的 Node.js 版本列表可选输入available则显示可获取的版本下载列表# 查看本机已安装版本 nvm list # 查看远程可下载的版本列表 nvm list available卸载指定版本# version 可选设置 latest/lts/newest nvm uninstall versionversion参数除具体版本号外支持以下特殊取值取值含义latest卸载最新版本lts卸载最近的 LTS 版本newest卸载最近安装的版本启用newest即指定卸载最近安装的那个版本适合清理刚装上又不想要的版本。nvm uninstall 16.20.2 # 卸载指定版本 nvm uninstall newest # 卸载最近安装的版本提示卸载前请确认当前使用版本不是目标版本否则可能造成当前会话的 node 命令失效。架构与进程管理查看 node 运行模式nvm arch [32|64]不带参数时查看 node 程序是运行在32位还是64位模式下指定32或64则可以覆盖默认运行架构模式nvm arch # 查看当前运行架构 nvm arch 64 # 将默认运行架构切换为 64 位检查 NVM4W 进程已知问题nvm check用于检查 NVM4Wnvm-windows进程的已知问题。当 nvm 命令表现异常如版本切换后 node 命令不生效、文件被占用等时可先运行此命令做一次自检再根据提示处理。启用 / 关闭与代理、目录配置启用 / 关闭 node.js 版本管理nvm on # 启用 nvm off # 关闭 - 不会执行任何卸载操作nvm off只是暂时关闭版本管理功能node 命令可能恢复为系统原有版本不会执行任何卸载操作已安装的版本依然保留随时可用nvm on重新启用。设置下载代理nvm proxy [url]用于配置下载 Node.js 版本时使用的代理服务器用法含义nvm proxyurl 留空查看当前使用的代理nvm proxy url设置代理地址nvm proxy none移除代理设置nvm proxy # 查看当前代理 nvm proxy http://127.0.0.1:7890 # 设置代理 nvm proxy none # 移除代理设置版本存储目录nvm root path设置 nvm 储存不同版本 Node.js 的目录。如果未设置 path将展示当前存储目录nvm root # 查看当前存储目录 nvm root D:\dev\nvm # 将存储目录设置为 D:\dev\nvm展示当前 nvm 使用版本nvm version输出当前 nvm 自身的版本号注意区别于nvm current展示的是 Node.js 版本可用于确认 nvm 是否成功安装、以及排查升级问题。node / npm 镜像配置默认情况下nvm 从官方源下载 Node.js 与 npm。在国内网络环境下下载速度可能较慢或失败此时可以通过镜像地址加速。指定 node 镜像nvm node_mirror node_mirror_url设置下载 Node.js 的镜像地址例如常见的国内镜像源如 npmmirror 提供的 node 镜像nvm node_mirror https://npmmirror.com/mirrors/node/指定 npm 镜像nvm npm_mirror npm_mirror_url设置下载 npm 的镜像地址nvm npm_mirror https://npmmirror.com/mirrors/npm/实践建议node_mirror与npm_mirror建议成对配置镜像配置对 nvm-windows 的下载加速效果尤其明显。配置后重新执行nvm install version即可验证下载源是否生效。常用组合与注意事项结合以上命令一个典型的从零配置多版本 Node.js 环境流程如下安装 nvmWindows 用setup程序macOS/Linux 用 curl/wget 安装脚本可选配置镜像nvm node_mirror url、nvm npm_mirror url安装所需版本nvm install 20、nvm install 18 lts等查看与切换nvm list确认已装版本nvm use 20切换生效版本验证node --version、npm --version确认环境正确。使用中需要注意nvm current与nvm version分别对应Node.js 版本与nvm 自身版本不要混淆nvm off只关闭版本管理不卸载任何内容可放心反复开关本备忘清单中arch、proxy、root、on/off、check、node_mirror、npm_mirror等命令以 nvm-windowsNVM4W为准在 macOS/Linux 的 nvm-sh 环境中日常主要使用install、use、list、current、uninstall等版本管理命令遇到异常时先执行nvm check自检进程问题再用nvm proxy、nvm root核对代理与存储目录配置。这份备忘清单收录于 reference 仓库的 docs/nvm.md与 npm、pnpm、package.json 等 Node.js 生态文档相互配套可组合查阅构成完整的 Node.js 工具链速查体系。赞分享文档知识库教程开发工具【免费下载链接】reference为开发人员分享快速参考备忘清单(速查表)项目地址https://gitcode.com/jaywcjlove/reference点击查看免费下载相关推荐reference 项目速查nvm 备忘清单——Node.js 多版本安装、切换与镜像配置实战指南reference 项目速查nvm 备忘清单——Node.js 多版本安装、切换与镜像配置实战指南 本篇技术指南以 docs/nvm.md https://l文档教程RedwoodJS 使用 nvm 管理 Node.js 版本安装、切换与版本要求实战指南RedwoodJS 使用 nvm 管理 Node.js 版本安装、切换与版本要求实战指南 nvmNode Version Manager是 Redwood后端前端Web框架开发工具使用 nvm 管理 Node.js 版本RedwoodJS 项目中的安装、切换与版本匹配实战使用 nvm 管理 Node.js 版本RedwoodJS 项目中的安装、切换与版本匹配实战 本篇技术指南围绕 RedwoodJS 官方文档《Using nv后端前端Web框架开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考