2026最新Node.js+NVM全平台安装教程

2026最新Node.jsNVM全平台安装教程前言在前端、后端全栈开发中Node.js是必不可少的运行环境而不同项目往往依赖不同的 Node.js 版本手动安装卸载不仅麻烦还容易冲突。NVMNode Version Manager作为 Node.js 版本管理神器完美解决多版本切换问题支持一键安装、切换、卸载任意 Node.js 版本是开发者的必备工具。本文是2026 年最新保姆级教程覆盖Windows 10/11、macOS、Linux全平台从前置卸载旧版本 → NVM 安装 → Node.js 安装 → 环境优化 → 功能测试全程无坑新手跟着操作 10 分钟即可搞定 前置操作彻底卸载旧版 Node.js必做如果你的电脑之前手动安装过 Node.js必须先彻底卸载干净否则会和 NVM 产生冲突导致各种奇怪的问题Windows 系统卸载步骤打开控制面板 → 程序和功能找到Node.js右键选择「卸载」按照向导完成卸载删除残留目录如果存在C:\Program Files\nodejsC:\Users[你的用户名]\AppData\Roaming\npmC:\Users[你的用户名]\AppData\Roaming\npm-cache清理环境变量右键「此电脑」→ 属性 → 高级系统设置 → 环境变量在用户变量和系统变量的Path中删除所有包含node、npm的路径验证清理打开新的 CMD/PowerShell输入node -v如果提示「不是内部或外部命令」说明卸载干净了Mac/Linux 系统卸载步骤如果之前用brew安装的brew uninstallnode如果之前用官网安装包安装的手动删除残留sudorm-rf/usr/local/{bin/node,lib/node_modules,include/node}sudorm-rf~/.npm ~/.node-gyp清理 shell 配置文件~/.bashrc、~/.zshrc中旧的 Node 相关环境变量验证清理打开终端输入node -v提示命令不存在即清理成功。一、NVM 版本管理器安装全流程⚠️ 注意Windows 系统和 Mac/Linux 系统的 NVM 是两个不同的项目安装方式完全不同不要搞混1.1 Windows 平台安装 NVMWindows 没有原生的 NVM我们使用社区维护的nvm-windows一键安装自动配置环境变量新手友好步骤 1下载最新版安装包官方 GitHub 下载地址https://github.com/coreybutler/nvm-windows/releases找到最新版本2026 年最新稳定版为1.1.12下载nvm-setup.exe推荐安装版免手动配置不要下载 zip 压缩包步骤 2一键安装双击运行nvm-setup.exe同意许可协议点击「Next」选择 NVM 安装路径建议非中文、无空格路径比如D:\dev\nvmNode.js 快捷方式路径默认即可比如C:\Program Files\nodejs一路点击「Next」→「Install」等待安装完成。步骤 3验证安装打开CMD 或 PowerShell建议管理员身份输入命令nvm version如果输出版本号如1.1.12说明 NVM 安装成功步骤 4配置淘宝镜像加速下载必做国内下载 Node.js 速度慢我们配置 npmmirror 淘宝镜像大幅提升下载速度打开 NVM 的安装目录比如D:\dev\nvm找到settings.txt文件在文件末尾添加以下两行配置node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/保存文件即可无需重启。1.2 Mac/Linux 平台安装 NVMMac 和 Linux 系统使用官方的nvm-sh通过一键脚本即可完成安装。步骤 1执行安装脚本打开终端执行以下命令2026 年最新稳定版为v0.39.7# 使用 curl 安装curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bash# 如果没有 curl用 wget 也可以# wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash步骤 2配置环境变量安装脚本会自动尝试将配置添加到你的 shell 配置文件中但部分系统可能需要手动操作打开你的 shell 配置文件如果你使用的是默认的 bash~/.bashrc或~/.bash_profile如果你使用的是 zshMac 新版默认~/.zshrc在文件末尾添加以下内容exportNVM_DIR$([-z${XDG_CONFIG_HOME-}]printf%s${HOME}/.nvm||printf%s${XDG_CONFIG_HOME}/nvm)[-s$NVM_DIR/nvm.sh]\.$NVM_DIR/nvm.sh让配置立即生效# 如果是 bashsource~/.bashrc# 如果是 zshsource~/.zshrc步骤 3验证安装在终端输入命令nvm--version输出版本号如0.39.7即安装成功步骤 4配置淘宝镜像加速下载同样为了加速下载我们配置环境变量在你的 shell 配置文件中添加以下内容exportNVM_NODEJS_ORG_MIRRORhttps://npmmirror.com/mirrors/node添加后执行source ~/.zshrc或对应配置文件让配置生效。二、Node.js 安装与版本管理全平台通用NVM 安装完成后安装 Node.js 就非常简单了所有平台的命令都是通用的2.1 查看可安装的 Node.js 版本nvm list available会列出所有可安装的版本我们优先选择LTS长期支持版稳定可靠企业开发首选。2.2 安装 LTS 长期支持版2026 年推荐安装最新的 LTS 版本v22.14.0维护到 2027 年稳定无坑执行命令# 安装指定版本nvminstall22.14.0# 或者直接安装最新的 LTS 版本自动识别nvminstall--lts等待下载完成会自动安装 Node.js 和对应的 npm 版本。2.3 切换使用该版本安装完成后需要切换到刚安装的版本nvm use22.14.0如果输出Now using node v22.14.0 (npm v10.8.1)说明切换成功2.4 设置默认版本必做默认情况下每次打开新的终端都需要重新nvm use我们可以设置默认版本打开终端自动生效nvmaliasdefault22.14.0设置完成后以后打开终端直接就是这个版本无需手动切换2.5 验证 Node.js 安装输入以下命令查看版本号# 查看 Node.js 版本node-v# 查看 npm 版本npm-v如果都能正常输出版本号说明 Node.js 安装成功三、环境优化配置 npm 淘宝源装完 Node.js 后npm 默认的源是国外的下载包很慢我们配置淘宝的 npmmirror 源大幅提升下载速度npmconfigsetregistry https://registry.npmmirror.com验证配置是否生效npmconfig get registry输出https://registry.npmmirror.com就说明配置成功了可选如果你想使用更快的包管理工具 pnpm可以执行以下命令安装npminstall-gpnpm四、功能测试全流程安装完成后我们来完整测试一下 Node.js 和 npm 的功能是否正常。4.1 基础运行测试我们先测试最基础的 Node.js 代码运行新建一个测试文件夹比如node-test进入文件夹新建test.js文件写入以下代码// 测试 Node.js 基础运行console.log( Hello Node.js你的环境安装成功啦);// 测试基础计算consta100,b200;console.log(100 200 ${ab});// 测试 ES6 语法constarr[1,2,3,4];console.log(数组过滤结果,arr.filter(itemitem2));在文件夹下打开终端执行命令nodetest.js如果输出以下内容说明基础环境完全正常 Hello Node.js你的环境安装成功啦 100 200 300 数组过滤结果 [ 3, 4 ]4.2 内置 HTTP 服务测试Node.js 自带了 HTTP 模块我们来测试一下能不能启动一个 Web 服务在同一个文件夹下新建server.js写入代码consthttprequire(http);// 创建服务constserverhttp.createServer((req,res){res.writeHead(200,{Content-Type:text/plain; charsetutf-8});res.end(✅ Node.js HTTP 服务启动成功);});// 监听 3000 端口server.listen(3000,(){console.log(服务已启动访问http://localhost:3000);});执行命令启动服务nodeserver.js打开浏览器访问http://localhost:3000如果看到「Node.js HTTP 服务启动成功」说明 Web 服务正常按Ctrl C停止服务。4.3 npm 包管理测试我们来测试一下 npm 能不能正常安装和使用第三方包初始化项目npminit-y会自动生成package.json配置文件。安装常用的网络请求包axiosnpminstallaxios新建axios-test.js写入测试代码constaxiosrequire(axios);// 测试请求 GitHub APIaxios.get(https://api.github.com).then(res{console.log(✅ 请求成功状态码,res.status);console.log(GitHub API 返回数据正常);}).catch(err{console.log(❌ 请求失败,err.message);});执行测试nodeaxios-test.js如果输出以下内容说明 npm 包管理完全正常✅ 请求成功状态码 200 GitHub API 返回数据正常五、NVM 常用命令大全整理了日常开发中最常用的 NVM 命令收藏备用# 查看已安装的 Node 版本nvm list# 查看可安装的所有版本nvm list available# 安装指定版本nvminstallversion# 安装最新的 LTS 版本nvminstall--lts# 切换到指定版本nvm useversion# 设置默认版本nvmaliasdefaultversion# 卸载指定版本nvm uninstallversion# 查看当前使用的版本nvm current六、常见问题与解决方案1.nvm command not found命令找不到原因Mac/Linux 下环境变量没配置好或者没 source 配置文件解决重新执行source ~/.zshrc或对应 shell 配置文件检查配置文件里的 NVM 配置是否正确。2. Windows 下nvm use报错切换版本失败原因权限不足或者之前的旧 Node 没卸载干净解决以管理员身份运行 CMD/PowerShell重新执行nvm use如果还是不行检查旧版本是否卸载干净。3. 下载 Node.js 速度很慢解决按照本文的步骤配置 NVM 的淘宝镜像配置完重新安装即可。4. 切换 Node 版本后全局安装的包不见了原因不同 Node 版本的全局包是独立的这是 NVM 的设计避免版本冲突解决如果需要全局包可以在切换版本后重新安装或者使用nvm install node --reinstall-packages-fromprevious迁移旧版本的全局包。5.node / npm命令不是内部或外部命令解决重启终端重新执行nvm use切换版本检查 NVM 是否安装成功。总结优先使用 NVM 管理 Node.js 版本避免多项目版本冲突是开发者的最佳选择安装 NVM 前一定要彻底卸载旧的 Node.js否则会导致冲突国内用户一定要配置淘宝镜像大幅提升下载速度安装完成后通过基础测试、HTTP 服务测试、npm 包测试验证环境是否正常。按照本教程操作不管你是 Windows、Mac 还是 Linux都能 10 分钟内搞定完整的 Node.js 开发环境新手零失败我是你的前端开发伙伴专注分享全栈开发、环境搭建、实战教程如果你觉得这篇文章有用欢迎点赞、收藏、关注后续持续更新 2026 最新开发干货