你好呀我是断弦承露感谢陪伴 小白博主在线求友 跟着小白学/Java/软件设计/鸿蒙开发/芯片开发专栏汇总《软件设计师》专栏 | 《Java》专栏 | 《 RISC-V 处理器实战》专栏 | 《Flutter鸿蒙实战》专栏 | 《React Native开发》专栏——|CSDN|——文章目录2026必看Node.js全平台安装教程小白0踩坑摘要文章核心思维导图一、先搞懂Node.js是啥为啥要装人话版二、安装前必做2步自检少走90%弯路2.1 检查系统兼容性2026年最新要求2.2 检查是否已装Node.js避免版本冲突步骤1打开命令行/终端精准步骤步骤2执行检查命令复制即用️三、分平台安装教程三种方法按需选择3.1 方法1官网一键安装新手首选最简单步骤1下载安装包精准避坑步骤2Windows安装步骤3macOS安装M1/M2/Intel通用步骤4验证安装一步确认3.2 方法2包管理器安装Linux/macOS推荐更高效macOSHomebrew安装M1/M2/Intel通用LinuxUbuntu/DebianLinuxCentOS/RHEL3.3 方法3nvm安装多版本切换开发者必备步骤1安装nvm2026年稳定版步骤2验证nvm安装步骤3用nvm安装/切换Node.js精准操作四、安装后必做配置提速避坑4.1 手动配置环境变量Windows装完报错必看4.2 配置npm国内镜像提速10倍解决下载慢/失败临时使用单次安装生效永久配置一劳永逸推荐❓五、全网最全FAQ避坑指南解决99%的问题Q1Windows装完提示「node 不是内部或外部命令」Q2macOS/Linux安装后提示「Permission denied」Q3nvm安装后提示「nvm: command not found」Q4npm装包提示「npm ERR! code EACCES」Q5M1/M2芯片macOS安装Node.js报错Q6nvm切换版本后提示「node: command not found」核心要点总结权威参考链接点击可跳转2026必看Node.js全平台安装教程小白0踩坑摘要本文专为前端零基础新手打造用「录屏式手把手」的方式拆解2026年Node.js的三种安装方法官网一键安装新手首选⚡、包管理器安装Linux/macOS高效版、nvm版本管理安装多版本切换刚需。覆盖Windows10/11、macOSM1/M2/Intel、Linux全系统基于Node.js v20.12.1 LTS2026最新长期支持版实测✅包含环境验证、npm国内镜像配置、99%常见报错修复哪怕你刚接触前端跟着复制粘贴也能10分钟搞定Node.js环境搭建文章核心思维导图2026 Node.js全平台安装安装前准备 检查是否已装Node.js确认系统兼容性分平台安装教程 ️Windows安装官网/nvmmacOS安装官网/brew/nvmLinux安装apt/yum/nvm安装后配置 ⚙️环境验证node/npm版本npm国内镜像配置提速避坑指南FAQ常见问题 ❓安装失败类问题版本兼容类问题环境变量类问题一、先搞懂Node.js是啥为啥要装人话版Node.js不是「JavaScript的升级版」而是能让JavaScript脱离浏览器、在电脑本地运行的「运行环境」✅ 核心作用运行Vue/React前端项目、通过npm装前端依赖包、开发Express/Koa后端接口✅ 配套工具npmNode Package Manager——Node.js自带的包管理器一键下载/管理第三方依赖✅ 2026年推荐版本LTS长期支持版v20.12.1稳定无兼容坑❗新手绝对别装Current测试版容易踩雷二、安装前必做2步自检少走90%弯路2.1 检查系统兼容性2026年最新要求系统类型最低要求推荐版本WindowsWindows 10 64位Windows 11 64位macOSmacOS 12 (Monterey)macOS 14 (Sonoma)M1/M2/IntelLinux内核5.4、glibc 2.28Ubuntu 22.04 LTS/CentOS 9 小提醒32位系统已被Node.js 20.x放弃支持务必确认是64位系统2.2 检查是否已装Node.js避免版本冲突步骤1打开命令行/终端精准步骤系统打开方式Windows按WinR→ 输入cmd→ 回车优先用CMDPowerShell也可macOS按Command空格→ 输入「终端」→ 回车Spotlight搜索最快Linux按CtrlAltT通用快捷键所有发行版都适配步骤2执行检查命令复制即用# 检查Node.js版本完整写法node--version# 简写日常更常用node-v# 检查npm版本Node.js自带无需单独安装npm--version# 简写npm-v✅ 成功已装显示v20.12.1Node.js、10.5.0npm❌ 失败未装提示「‘node’ 不是内部或外部命令」/「command not found」→ 开始安装这种提示也有可能是环境变量没配好️三、分平台安装教程三种方法按需选择3.1 方法1官网一键安装新手首选最简单步骤1下载安装包精准避坑打开Node.js官网Node.js官方下载选项用途适合人群你为啥不能选nvmNode.js版本管理器能在本机切换多个Node.js版本需要同时跑多个老项目的开发者你现在连基础安装都没搞定多版本管理完全用不上反而会增加环境变量的复杂度fnm和nvm功能一样更小众的版本管理器追求更快速度的进阶开发者比nvm还小众出了问题网上教程都少新手直接passDocker容器化工具把Node.js打包进隔离环境项目部署/跨环境测试之前反复和你说过新手本地开发用Docker会出现「容器里能跑node本机终端找不到node」的问题纯纯绕弯路BrewmacOS专属的包管理器macOS用户Windows系统完全用不了点了也白搭ChocolateyWindows的命令行包管理器熟悉Windows终端的开发者你需要先单独装Chocolatey才能用多一层学习成本完全没必要nLinux/macOS专属的Node版本管理器Linux/macOS开发者Windows系统不支持直接忽略选项是什么适合人群新手为啥不选npmNode.js官方自带的包管理器和Node.js绑定安装装完Node.js直接就能用所有开发者尤其新手唯一零门槛、教程最多、遇到问题随便搜都能解决的选项新手的最优解Yarn纱线第三方包管理器早年是为了解决npm老版本的速度、依赖一致性问题开发的有大型项目协作需求的进阶开发者1. 需要你装完Node.js后额外用命令手动安装2. 要重新学一套和npm不一样的命令3. 现在npm新版本已经解决了早年的所有短板新手用它纯纯多此一举pnpm第三方包管理器主打「速度更快、更省磁盘空间」有特殊的依赖管理逻辑对性能、磁盘占用有要求的进阶开发者1. 同样需要额外手动安装2. 特殊的依赖管理逻辑新手遇到依赖问题根本排查不了3. 网上新手向的教程远少于npm踩坑了很难找到解决方案优先选「LTS版本」标注v20.12.1红色「Current」版直接跳过对应系统下载Windows选「Windows 安装程序 (.msi)」64位文件名含x64双击安装如果下载了第三方解压软件可能将其识别为安装包千万别解压只需单击鼠标右键选打开方式打开Windows 系统的官方安装程序点这里换成其它盘安装如果有所有选项保持默认什么都不用改直接点右下角的「Next」继续安装就行Node.js runtimeNode.js 的核心运行程序必须装不装就用不了 Node.js默认必选。corepack manager包管理工具的辅助管理器后续如果你想用 yarn/pnpm 会用到默认装上没任何坏处不用管。npm package managerNode.js 官方自带的包管理器是你后续装依赖、跑项目的核心工具必须装默认必选。Online documentation shortcuts官方文档的快捷方式占空间极小留着以后查官方教程很方便不用动。Add to PATH最最关键的选项必须保持勾选这个选项会自动帮你配置好系统环境变量勾上之后安装完成重启终端就能直接在 CMD/PowerShell 里用node和npm命令新手绝对不能取消这个勾选这个复选框「Automatically install the necessary tools…」不要勾选 直接点右下角的「Next」继续完成安装就行。 这个界面是干啥的为啥不用勾这个界面是问你要不要额外自动安装「编译原生 C/C 模块的工具」包含 Python、Visual Studio Build Tools、Chocolatey 包管理器新手完全不需要装完成macOS选「macOS 安装程序 (.pkg)」Intel/M1/M2通用无需区分Linux选「Linux 二进制文件x64」适配Ubuntu/CentOS等主流发行版步骤2Windows安装双击下载的node-v20.12.1-x64.msi→ 点击「Next」勾选「I accept the terms in the License Agreement」→ 「Next」安装路径默认C:\Program Files\nodejs\新手禁止修改改路径必出环境变量问题确认勾选核心选项默认已勾核对无误[✓] Node.js runtime核心运行环境[✓] npm package manager包管理器[✓] Add to PATH自动配环境变量最关键点击「Install」→ 等待1-2分钟 → 「Finish」 必做操作关闭所有CMD/终端重新打开环境变量才会生效步骤3macOS安装M1/M2/Intel通用双击下载的node-v20.12.1.pkg→ 点击「继续」同意许可协议 → 点击「安装」→ 输入电脑登录密码安装完成点击「关闭」→ 重启终端不重启检测不到版本❌步骤4验证安装一步确认重新打开命令行/终端执行node-v# 正确输出v20.12.1npm-v# 正确输出10.5.0✅ 成功显示对应版本号 → 安装完成这个报错不是 npm 没装好是 Windows PowerShell 的默认安全策略限制禁止了未签名的脚本运行npm 的启动脚本被系统拦截了改个安全设置就能解决不会影响系统安全。Windows PowerShell执行策略详解从npm报错到完美解决https://blog.csdn.net/2602_94958286/article/details/159324301?spm1011.2415.3001.10575sharefrommp_manage_link一必须以【管理员身份】打开PowerShell核心前提普通权限改不了系统策略必须开管理员终端点击Windows左下角的开始菜单搜索PowerShell右键搜索结果里的「Windows PowerShell」选择【以管理员身份运行】弹出的「用户账户控制」提示直接点「是」打开管理员终端。二执行修改安全策略的命令在打开的管理员PowerShell窗口里完整复制下面这行命令粘贴进去按回车Set-ExecutionPolicyRemoteSigned执行后会弹出确认提示是否要更改执行策略?输入大写的Y再按回车确认。 安全说明RemoteSigned是Windows官方推荐的安全策略意思是本地脚本可以正常运行网上下载的脚本必须有官方数字签名才能运行既解决了npm的报错又完全不会降低系统安全性放心用。三重启所有终端验证是否成功把现在的管理员PowerShell、之前的普通终端窗口全部关掉重新打开一个普通的PowerShell不用管理员了输入验证命令正常显示版本号就代表成功了npm --versionnode --version四正常安装pnpm现在npm已经能用了直接执行安装命令就能装上pnpmnpminstall-gpnpm安装完成后用pnpm --version验证显示版本号就全部搞定了。要是之前没勾选对应内容后续需要npm的话这样做重新运行 Node.js 的.msi 安装包选择「Modify」修改安装在功能选择界面确保「npm package manager」是勾选状态一路 Next 完成修改重启终端再试。3.2 方法2包管理器安装Linux/macOS推荐更高效macOSHomebrew安装M1/M2/Intel通用# 第一步安装Homebrew未装过才执行国内用户建议加镜像/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 第二步安装Node.js v20 LTS指定版本避免装错测试版brewinstallnode20# 第三步配置环境变量M1/M2必做Intel可选echoexport PATH/opt/homebrew/opt/node20/bin:$PATH~/.zshrcsource~/.zshrc 名词解释brew是macOS专属包管理器类似应用商店node20指定v20系列LTS版避免brew自动装最新测试版export PATH把Node.js路径加入终端环境变量确保全局可用。LinuxUbuntu/Debian# 第一步添加Node.js官方源避免系统源版本过旧curl-fsSLhttps://deb.nodesource.com/setup_20.x|sudo-Ebash-# 第二步安装Node.js含npm一键搞定sudoaptupdatesudoaptinstall-ynodejs# 验证安装node-vLinuxCentOS/RHEL# 第一步添加Node.js官方源curl-fsSLhttps://rpm.nodesource.com/setup_20.x|sudobash-# 第二步安装Node.jssudoyuminstall-ynodejs# 验证安装node-v3.3 方法3nvm安装多版本切换开发者必备如果需要同时运行多个Node.js版本如老项目v16、新项目v20nvmNode Version Manager是最优解一键切换无冲突。步骤1安装nvm2026年稳定版# Windows单独安装nvm-windows# 下载地址https://github.com/coreybutler/nvm-windows/releases# 选「nvm-setup.exe」安装路径默认避免中文/空格一路下一步# macOS/Linux终端一键安装国内用户建议用镜像curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bash 名词解释nvm是「Node Version Manager」缩写命名直接体现核心功能——管理Node.js版本v0.39.7是2026年仍稳定的版本兼容性拉满。步骤2验证nvm安装# Windows/macOS/Linux通用nvm--version✅ 成功macOS/Linux显示0.39.7Windows显示1.1.11步骤3用nvm安装/切换Node.js精准操作# 查看可安装的Node.js版本筛选LTS版nvm list available# 安装2026年推荐的v20.12.1指定完整版本避免装错nvminstall20.12.1# 切换到该版本nvm use20.12.1# 设置为默认版本每次打开终端自动用这个版本不用重复切换nvmaliasdefault20.12.1# 查看已安装的版本列表nvm list 关键说明nvm install 20.12.1指定完整版本号比只写20更精准nvm alias default设置默认版本告别每次重启终端手动切换的麻烦。四、安装后必做配置提速避坑4.1 手动配置环境变量Windows装完报错必看若装完后node -v提示「找不到命令」说明环境变量未自动配置手动修复步骤右键「此电脑」→ 「属性」→ 「高级系统设置」→ 「环境变量」在「系统变量」中找到「Path」→ 点击「编辑」点击「新建」→ 粘贴Node.js安装路径默认C:\Program Files\nodejs\点击「确定」×3 → 重启所有CMD/终端 → 重新执行node -v4.2 配置npm国内镜像提速10倍解决下载慢/失败npm默认用国外源国内访问极慢必换淘宝镜像2026年最新地址临时使用单次安装生效# 安装包时指定镜像例安装axiosnpminstallaxios--registryhttps://registry.npmmirror.com/永久配置一劳永逸推荐# 设置默认镜像源npmconfigsetregistry https://registry.npmmirror.com/# 验证配置是否生效关键步骤npmconfig get registry✅ 成功输出https://registry.npmmirror.com/ 名词解释registry是npm的「镜像源地址」配置项npm config set用于修改配置npm config get用于查看配置npmmirror.com是淘宝镜像2026年官方域名替代旧的taobao.org。❓五、全网最全FAQ避坑指南解决99%的问题Q1Windows装完提示「‘node’ 不是内部或外部命令」 原因安装路径未加入环境变量/修改了默认路径/未重启终端✅ 解决确认Node.js安装路径默认C:\Program Files\nodejs\按「4.1」步骤手动配置环境变量关闭所有终端重新打开测试Q2macOS/Linux安装后提示「Permission denied」 原因无管理员权限写入全局目录或npm默认路径权限不足✅ 解决# 修复npm全局目录权限macOS/Linux通用sudochown-R$USER/usr/local/lib/node_modules# 验证权限无报错即成功npminstall-gnpm 名词解释$USER是系统内置变量代表当前登录用户名chown -R递归修改文件所有者把npm目录改为当前用户所有-g是--global简写代表全局安装。Q3nvm安装后提示「nvm: command not found」 原因nvm未加入终端配置文件macOS/Linux或安装路径含中文/空格Windows✅ 解决macOS/Linux打开终端配置文件zsh用户用.zshrcbash用户用.bash_profilenano~/.zshrc粘贴nvm环境变量配置exportNVM_DIR$HOME/.nvm[-s$NVM_DIR/nvm.sh]\.$NVM_DIR/nvm.sh按CtrlO→Enter保存 →CtrlX退出 → 执行source ~/.zshrc生效✅ 解决Windows卸载当前nvm → 重新下载nvm-setup.exe右键「以管理员身份运行」安装 → 路径默认避免中文/空格安装完成重启终端Q4npm装包提示「npm ERR! code EACCES」 原因全局安装包时权限不足无法写入系统目录✅ 解决永久方案推荐# 1. 创建npm全局包自定义目录避开系统目录权限问题mkdir-p~/.npm-global# 2. 配置npm全局路径指向该目录npmconfigsetprefix ~/.npm-global# 3. 将自定义目录加入环境变量echoexport PATH~/.npm-global/bin:$PATH~/.zshrcsource~/.zshrcQ5M1/M2芯片macOS安装Node.js报错 原因老版本安装包不兼容ARM架构或brew源未适配✅ 解决卸载旧版本sudo rm -rf /usr/local/bin/node /usr/local/bin/npm用brew安装适配版本brew install node20优先选brew而非官网pkg执行brew link --overwrite node20修复软链接解决版本冲突Q6nvm切换版本后提示「node: command not found」 原因nvm未生成软链接或终端未刷新环境变量✅ 解决# 重新生成软链接nvmaliasdefault20.12.1# 刷新终端环境变量source~/.zshrc# zsh用户# 或source~/.bash_profile# bash用户核心要点总结 新手优先选「官网一键安装」默认路径不修改装完必须重启终端️ 多版本切换必用nvm安装时指定完整版本号如20.12.1避免版本混乱⚡ 装完必配npm国内镜像npmmirror.com解决下载慢/失败的核心问题 报错优先排查「环境变量」和「权限」90%的安装问题都源于这两点。权威参考链接点击可跳转Node.js官方下载2026最新LTS版v20.12.1nvm-windows官方文档nvm官方文档npm镜像源官方说明 互动环节如果安装过程中遇到其他问题评论区留言说明你的系统完整报错信息我会第一时间帮你定位问题收藏这篇教程⭐下次配置Node.js环境不用再踩坑关注我获取更多2026年最新前端环境配置教程如果本文对你有帮助欢迎点赞、收藏⭐、评论!个人领域:C/java/Al/软件开发/芯片开发个人主页:「一名热衷协作的开发者在构建中学习期待与你交流技术、共同成长。」座右铭:「与其完美地观望不如踉跄地启程」
Node.js全平台安装教程
你好呀我是断弦承露感谢陪伴 小白博主在线求友 跟着小白学/Java/软件设计/鸿蒙开发/芯片开发专栏汇总《软件设计师》专栏 | 《Java》专栏 | 《 RISC-V 处理器实战》专栏 | 《Flutter鸿蒙实战》专栏 | 《React Native开发》专栏——|CSDN|——文章目录2026必看Node.js全平台安装教程小白0踩坑摘要文章核心思维导图一、先搞懂Node.js是啥为啥要装人话版二、安装前必做2步自检少走90%弯路2.1 检查系统兼容性2026年最新要求2.2 检查是否已装Node.js避免版本冲突步骤1打开命令行/终端精准步骤步骤2执行检查命令复制即用️三、分平台安装教程三种方法按需选择3.1 方法1官网一键安装新手首选最简单步骤1下载安装包精准避坑步骤2Windows安装步骤3macOS安装M1/M2/Intel通用步骤4验证安装一步确认3.2 方法2包管理器安装Linux/macOS推荐更高效macOSHomebrew安装M1/M2/Intel通用LinuxUbuntu/DebianLinuxCentOS/RHEL3.3 方法3nvm安装多版本切换开发者必备步骤1安装nvm2026年稳定版步骤2验证nvm安装步骤3用nvm安装/切换Node.js精准操作四、安装后必做配置提速避坑4.1 手动配置环境变量Windows装完报错必看4.2 配置npm国内镜像提速10倍解决下载慢/失败临时使用单次安装生效永久配置一劳永逸推荐❓五、全网最全FAQ避坑指南解决99%的问题Q1Windows装完提示「node 不是内部或外部命令」Q2macOS/Linux安装后提示「Permission denied」Q3nvm安装后提示「nvm: command not found」Q4npm装包提示「npm ERR! code EACCES」Q5M1/M2芯片macOS安装Node.js报错Q6nvm切换版本后提示「node: command not found」核心要点总结权威参考链接点击可跳转2026必看Node.js全平台安装教程小白0踩坑摘要本文专为前端零基础新手打造用「录屏式手把手」的方式拆解2026年Node.js的三种安装方法官网一键安装新手首选⚡、包管理器安装Linux/macOS高效版、nvm版本管理安装多版本切换刚需。覆盖Windows10/11、macOSM1/M2/Intel、Linux全系统基于Node.js v20.12.1 LTS2026最新长期支持版实测✅包含环境验证、npm国内镜像配置、99%常见报错修复哪怕你刚接触前端跟着复制粘贴也能10分钟搞定Node.js环境搭建文章核心思维导图2026 Node.js全平台安装安装前准备 检查是否已装Node.js确认系统兼容性分平台安装教程 ️Windows安装官网/nvmmacOS安装官网/brew/nvmLinux安装apt/yum/nvm安装后配置 ⚙️环境验证node/npm版本npm国内镜像配置提速避坑指南FAQ常见问题 ❓安装失败类问题版本兼容类问题环境变量类问题一、先搞懂Node.js是啥为啥要装人话版Node.js不是「JavaScript的升级版」而是能让JavaScript脱离浏览器、在电脑本地运行的「运行环境」✅ 核心作用运行Vue/React前端项目、通过npm装前端依赖包、开发Express/Koa后端接口✅ 配套工具npmNode Package Manager——Node.js自带的包管理器一键下载/管理第三方依赖✅ 2026年推荐版本LTS长期支持版v20.12.1稳定无兼容坑❗新手绝对别装Current测试版容易踩雷二、安装前必做2步自检少走90%弯路2.1 检查系统兼容性2026年最新要求系统类型最低要求推荐版本WindowsWindows 10 64位Windows 11 64位macOSmacOS 12 (Monterey)macOS 14 (Sonoma)M1/M2/IntelLinux内核5.4、glibc 2.28Ubuntu 22.04 LTS/CentOS 9 小提醒32位系统已被Node.js 20.x放弃支持务必确认是64位系统2.2 检查是否已装Node.js避免版本冲突步骤1打开命令行/终端精准步骤系统打开方式Windows按WinR→ 输入cmd→ 回车优先用CMDPowerShell也可macOS按Command空格→ 输入「终端」→ 回车Spotlight搜索最快Linux按CtrlAltT通用快捷键所有发行版都适配步骤2执行检查命令复制即用# 检查Node.js版本完整写法node--version# 简写日常更常用node-v# 检查npm版本Node.js自带无需单独安装npm--version# 简写npm-v✅ 成功已装显示v20.12.1Node.js、10.5.0npm❌ 失败未装提示「‘node’ 不是内部或外部命令」/「command not found」→ 开始安装这种提示也有可能是环境变量没配好️三、分平台安装教程三种方法按需选择3.1 方法1官网一键安装新手首选最简单步骤1下载安装包精准避坑打开Node.js官网Node.js官方下载选项用途适合人群你为啥不能选nvmNode.js版本管理器能在本机切换多个Node.js版本需要同时跑多个老项目的开发者你现在连基础安装都没搞定多版本管理完全用不上反而会增加环境变量的复杂度fnm和nvm功能一样更小众的版本管理器追求更快速度的进阶开发者比nvm还小众出了问题网上教程都少新手直接passDocker容器化工具把Node.js打包进隔离环境项目部署/跨环境测试之前反复和你说过新手本地开发用Docker会出现「容器里能跑node本机终端找不到node」的问题纯纯绕弯路BrewmacOS专属的包管理器macOS用户Windows系统完全用不了点了也白搭ChocolateyWindows的命令行包管理器熟悉Windows终端的开发者你需要先单独装Chocolatey才能用多一层学习成本完全没必要nLinux/macOS专属的Node版本管理器Linux/macOS开发者Windows系统不支持直接忽略选项是什么适合人群新手为啥不选npmNode.js官方自带的包管理器和Node.js绑定安装装完Node.js直接就能用所有开发者尤其新手唯一零门槛、教程最多、遇到问题随便搜都能解决的选项新手的最优解Yarn纱线第三方包管理器早年是为了解决npm老版本的速度、依赖一致性问题开发的有大型项目协作需求的进阶开发者1. 需要你装完Node.js后额外用命令手动安装2. 要重新学一套和npm不一样的命令3. 现在npm新版本已经解决了早年的所有短板新手用它纯纯多此一举pnpm第三方包管理器主打「速度更快、更省磁盘空间」有特殊的依赖管理逻辑对性能、磁盘占用有要求的进阶开发者1. 同样需要额外手动安装2. 特殊的依赖管理逻辑新手遇到依赖问题根本排查不了3. 网上新手向的教程远少于npm踩坑了很难找到解决方案优先选「LTS版本」标注v20.12.1红色「Current」版直接跳过对应系统下载Windows选「Windows 安装程序 (.msi)」64位文件名含x64双击安装如果下载了第三方解压软件可能将其识别为安装包千万别解压只需单击鼠标右键选打开方式打开Windows 系统的官方安装程序点这里换成其它盘安装如果有所有选项保持默认什么都不用改直接点右下角的「Next」继续安装就行Node.js runtimeNode.js 的核心运行程序必须装不装就用不了 Node.js默认必选。corepack manager包管理工具的辅助管理器后续如果你想用 yarn/pnpm 会用到默认装上没任何坏处不用管。npm package managerNode.js 官方自带的包管理器是你后续装依赖、跑项目的核心工具必须装默认必选。Online documentation shortcuts官方文档的快捷方式占空间极小留着以后查官方教程很方便不用动。Add to PATH最最关键的选项必须保持勾选这个选项会自动帮你配置好系统环境变量勾上之后安装完成重启终端就能直接在 CMD/PowerShell 里用node和npm命令新手绝对不能取消这个勾选这个复选框「Automatically install the necessary tools…」不要勾选 直接点右下角的「Next」继续完成安装就行。 这个界面是干啥的为啥不用勾这个界面是问你要不要额外自动安装「编译原生 C/C 模块的工具」包含 Python、Visual Studio Build Tools、Chocolatey 包管理器新手完全不需要装完成macOS选「macOS 安装程序 (.pkg)」Intel/M1/M2通用无需区分Linux选「Linux 二进制文件x64」适配Ubuntu/CentOS等主流发行版步骤2Windows安装双击下载的node-v20.12.1-x64.msi→ 点击「Next」勾选「I accept the terms in the License Agreement」→ 「Next」安装路径默认C:\Program Files\nodejs\新手禁止修改改路径必出环境变量问题确认勾选核心选项默认已勾核对无误[✓] Node.js runtime核心运行环境[✓] npm package manager包管理器[✓] Add to PATH自动配环境变量最关键点击「Install」→ 等待1-2分钟 → 「Finish」 必做操作关闭所有CMD/终端重新打开环境变量才会生效步骤3macOS安装M1/M2/Intel通用双击下载的node-v20.12.1.pkg→ 点击「继续」同意许可协议 → 点击「安装」→ 输入电脑登录密码安装完成点击「关闭」→ 重启终端不重启检测不到版本❌步骤4验证安装一步确认重新打开命令行/终端执行node-v# 正确输出v20.12.1npm-v# 正确输出10.5.0✅ 成功显示对应版本号 → 安装完成这个报错不是 npm 没装好是 Windows PowerShell 的默认安全策略限制禁止了未签名的脚本运行npm 的启动脚本被系统拦截了改个安全设置就能解决不会影响系统安全。Windows PowerShell执行策略详解从npm报错到完美解决https://blog.csdn.net/2602_94958286/article/details/159324301?spm1011.2415.3001.10575sharefrommp_manage_link一必须以【管理员身份】打开PowerShell核心前提普通权限改不了系统策略必须开管理员终端点击Windows左下角的开始菜单搜索PowerShell右键搜索结果里的「Windows PowerShell」选择【以管理员身份运行】弹出的「用户账户控制」提示直接点「是」打开管理员终端。二执行修改安全策略的命令在打开的管理员PowerShell窗口里完整复制下面这行命令粘贴进去按回车Set-ExecutionPolicyRemoteSigned执行后会弹出确认提示是否要更改执行策略?输入大写的Y再按回车确认。 安全说明RemoteSigned是Windows官方推荐的安全策略意思是本地脚本可以正常运行网上下载的脚本必须有官方数字签名才能运行既解决了npm的报错又完全不会降低系统安全性放心用。三重启所有终端验证是否成功把现在的管理员PowerShell、之前的普通终端窗口全部关掉重新打开一个普通的PowerShell不用管理员了输入验证命令正常显示版本号就代表成功了npm --versionnode --version四正常安装pnpm现在npm已经能用了直接执行安装命令就能装上pnpmnpminstall-gpnpm安装完成后用pnpm --version验证显示版本号就全部搞定了。要是之前没勾选对应内容后续需要npm的话这样做重新运行 Node.js 的.msi 安装包选择「Modify」修改安装在功能选择界面确保「npm package manager」是勾选状态一路 Next 完成修改重启终端再试。3.2 方法2包管理器安装Linux/macOS推荐更高效macOSHomebrew安装M1/M2/Intel通用# 第一步安装Homebrew未装过才执行国内用户建议加镜像/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 第二步安装Node.js v20 LTS指定版本避免装错测试版brewinstallnode20# 第三步配置环境变量M1/M2必做Intel可选echoexport PATH/opt/homebrew/opt/node20/bin:$PATH~/.zshrcsource~/.zshrc 名词解释brew是macOS专属包管理器类似应用商店node20指定v20系列LTS版避免brew自动装最新测试版export PATH把Node.js路径加入终端环境变量确保全局可用。LinuxUbuntu/Debian# 第一步添加Node.js官方源避免系统源版本过旧curl-fsSLhttps://deb.nodesource.com/setup_20.x|sudo-Ebash-# 第二步安装Node.js含npm一键搞定sudoaptupdatesudoaptinstall-ynodejs# 验证安装node-vLinuxCentOS/RHEL# 第一步添加Node.js官方源curl-fsSLhttps://rpm.nodesource.com/setup_20.x|sudobash-# 第二步安装Node.jssudoyuminstall-ynodejs# 验证安装node-v3.3 方法3nvm安装多版本切换开发者必备如果需要同时运行多个Node.js版本如老项目v16、新项目v20nvmNode Version Manager是最优解一键切换无冲突。步骤1安装nvm2026年稳定版# Windows单独安装nvm-windows# 下载地址https://github.com/coreybutler/nvm-windows/releases# 选「nvm-setup.exe」安装路径默认避免中文/空格一路下一步# macOS/Linux终端一键安装国内用户建议用镜像curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bash 名词解释nvm是「Node Version Manager」缩写命名直接体现核心功能——管理Node.js版本v0.39.7是2026年仍稳定的版本兼容性拉满。步骤2验证nvm安装# Windows/macOS/Linux通用nvm--version✅ 成功macOS/Linux显示0.39.7Windows显示1.1.11步骤3用nvm安装/切换Node.js精准操作# 查看可安装的Node.js版本筛选LTS版nvm list available# 安装2026年推荐的v20.12.1指定完整版本避免装错nvminstall20.12.1# 切换到该版本nvm use20.12.1# 设置为默认版本每次打开终端自动用这个版本不用重复切换nvmaliasdefault20.12.1# 查看已安装的版本列表nvm list 关键说明nvm install 20.12.1指定完整版本号比只写20更精准nvm alias default设置默认版本告别每次重启终端手动切换的麻烦。四、安装后必做配置提速避坑4.1 手动配置环境变量Windows装完报错必看若装完后node -v提示「找不到命令」说明环境变量未自动配置手动修复步骤右键「此电脑」→ 「属性」→ 「高级系统设置」→ 「环境变量」在「系统变量」中找到「Path」→ 点击「编辑」点击「新建」→ 粘贴Node.js安装路径默认C:\Program Files\nodejs\点击「确定」×3 → 重启所有CMD/终端 → 重新执行node -v4.2 配置npm国内镜像提速10倍解决下载慢/失败npm默认用国外源国内访问极慢必换淘宝镜像2026年最新地址临时使用单次安装生效# 安装包时指定镜像例安装axiosnpminstallaxios--registryhttps://registry.npmmirror.com/永久配置一劳永逸推荐# 设置默认镜像源npmconfigsetregistry https://registry.npmmirror.com/# 验证配置是否生效关键步骤npmconfig get registry✅ 成功输出https://registry.npmmirror.com/ 名词解释registry是npm的「镜像源地址」配置项npm config set用于修改配置npm config get用于查看配置npmmirror.com是淘宝镜像2026年官方域名替代旧的taobao.org。❓五、全网最全FAQ避坑指南解决99%的问题Q1Windows装完提示「‘node’ 不是内部或外部命令」 原因安装路径未加入环境变量/修改了默认路径/未重启终端✅ 解决确认Node.js安装路径默认C:\Program Files\nodejs\按「4.1」步骤手动配置环境变量关闭所有终端重新打开测试Q2macOS/Linux安装后提示「Permission denied」 原因无管理员权限写入全局目录或npm默认路径权限不足✅ 解决# 修复npm全局目录权限macOS/Linux通用sudochown-R$USER/usr/local/lib/node_modules# 验证权限无报错即成功npminstall-gnpm 名词解释$USER是系统内置变量代表当前登录用户名chown -R递归修改文件所有者把npm目录改为当前用户所有-g是--global简写代表全局安装。Q3nvm安装后提示「nvm: command not found」 原因nvm未加入终端配置文件macOS/Linux或安装路径含中文/空格Windows✅ 解决macOS/Linux打开终端配置文件zsh用户用.zshrcbash用户用.bash_profilenano~/.zshrc粘贴nvm环境变量配置exportNVM_DIR$HOME/.nvm[-s$NVM_DIR/nvm.sh]\.$NVM_DIR/nvm.sh按CtrlO→Enter保存 →CtrlX退出 → 执行source ~/.zshrc生效✅ 解决Windows卸载当前nvm → 重新下载nvm-setup.exe右键「以管理员身份运行」安装 → 路径默认避免中文/空格安装完成重启终端Q4npm装包提示「npm ERR! code EACCES」 原因全局安装包时权限不足无法写入系统目录✅ 解决永久方案推荐# 1. 创建npm全局包自定义目录避开系统目录权限问题mkdir-p~/.npm-global# 2. 配置npm全局路径指向该目录npmconfigsetprefix ~/.npm-global# 3. 将自定义目录加入环境变量echoexport PATH~/.npm-global/bin:$PATH~/.zshrcsource~/.zshrcQ5M1/M2芯片macOS安装Node.js报错 原因老版本安装包不兼容ARM架构或brew源未适配✅ 解决卸载旧版本sudo rm -rf /usr/local/bin/node /usr/local/bin/npm用brew安装适配版本brew install node20优先选brew而非官网pkg执行brew link --overwrite node20修复软链接解决版本冲突Q6nvm切换版本后提示「node: command not found」 原因nvm未生成软链接或终端未刷新环境变量✅ 解决# 重新生成软链接nvmaliasdefault20.12.1# 刷新终端环境变量source~/.zshrc# zsh用户# 或source~/.bash_profile# bash用户核心要点总结 新手优先选「官网一键安装」默认路径不修改装完必须重启终端️ 多版本切换必用nvm安装时指定完整版本号如20.12.1避免版本混乱⚡ 装完必配npm国内镜像npmmirror.com解决下载慢/失败的核心问题 报错优先排查「环境变量」和「权限」90%的安装问题都源于这两点。权威参考链接点击可跳转Node.js官方下载2026最新LTS版v20.12.1nvm-windows官方文档nvm官方文档npm镜像源官方说明 互动环节如果安装过程中遇到其他问题评论区留言说明你的系统完整报错信息我会第一时间帮你定位问题收藏这篇教程⭐下次配置Node.js环境不用再踩坑关注我获取更多2026年最新前端环境配置教程如果本文对你有帮助欢迎点赞、收藏⭐、评论!个人领域:C/java/Al/软件开发/芯片开发个人主页:「一名热衷协作的开发者在构建中学习期待与你交流技术、共同成长。」座右铭:「与其完美地观望不如踉跄地启程」
