1. 先搞明白Node.js 是个运行时不是一门语言很多人第一次接触 Node.js 时会把它当成一门编程语言其实不是。Node.js 本质上是一个基于 Chrome V8 引擎的 JavaScript 运行时环境它的作用就是让 JavaScript 代码能在浏览器之外的地方运行。用大白话说以前 JavaScript 只能在浏览器里跑页面上的交互逻辑全靠它Node.js 出现之后JavaScript 可以跑到服务器上、命令行里能做后端服务、写工具脚本、搭开发服务器。前端开发者学会 Node.js 后相当于从只会在浏览器里写交互进阶到能用同一门语言写整个应用。那装了 Node.js 到底能干嘛往实际了说日常开发中至少有这几类事离不开它跑前端工程化工具比如 Webpack、Vite这些打包构建工具全都依赖 Node 环境用 npm 或 yarn 安装项目依赖包随便一个前端项目npm install就是家常便饭开发调试时启动本地服务Vue、React 脚手架创建的项目都用npm run dev起开发服务器自己写后端接口服务用 Express、Koa 或 NestJS 这些框架JavaScript 直接写服务端逻辑做各种自动化脚本比如批量处理文件、定时任务、爬虫Node 写起来非常顺手。这套教程的目标很明确无论你是零基础刚转行的新手还是以前只用过浏览器开发者工具的前端初学者都能照着下面的步骤在自己的电脑上完整装好 Node.js 并跑通第一个程序。我不会只丢给你一个安装包链接而是把版本选择、环境变量原理、常见报错排查一并讲透。整个安装配置过程说白了就三件事下载一个合适的安装包、装上去、把环境变量配到系统里。但合适两个字里藏着不少门道版本选错了、安装包类型挑错了后面都会让你头疼。所以别急着点下载先花两分钟把下面这部分看完。2. 安装前避坑版本选择、安装包类型与平台差异2.1 LTS 版和 Current 版怎么选进入 Node.js 官网首页你会看到两个醒目的下载按钮一个是 LTS一个是 Current。这里先说结论新手和绝大多数开发者直接选 LTS别犹豫。LTS 是 Long Term Support 的缩写意味着这个版本会获得长期维护官方持续修复 bug、补安全漏洞稳定性有保障。Current 版本则是最新版会率先加入新特性但更新节奏快可能引入破坏性变更适合想尝鲜或者需要用到新 API 的人。拿实际场景举例你用 Current 版本写完代码跑得好好的结果过了半年这个版本的某个依赖包出现兼容性问题被迫升级或降级折腾半天。反观 LTS 版本社区的软件包、依赖库都会优先保证兼容遇到问题的概率低得多。最近几年的 Node.js 版本号规律也比较清晰常见的 LTS 版本比如 18.x、20.x、22.x每个大版本迭代周期大概一年。如果你用的是 Vue3、Vite5、Webpack5 这类主流工具LTS 版本完全能满足需求没必要追新。2.2 Windows、macOS、Linux 各自怎么选安装包不同操作系统安装方式和工具链差别挺大这里先把结论列清楚操作系统推荐方式说明Windows官方 .msi 安装包图形化安装自动配置环境变量最省事macOS官方 .pkg 安装包类似 Windows 的 msi双击安装即可也可以用 Homebrew 装Linuxnvm 版本管理工具建议用 nvm 安装方便切换和管理多版本Windows 用户下载时注意架构选择现在绝大多数电脑是 64 位系统选 x64 版本。怎么看自己电脑是 64 位还是 32 位在 Windows 设置里搜系统信息或者右键此电脑→属性就能看到系统类型。如果你的电脑是近五六年买的基本可以默认 x64不用多想。macOS 用户要留意芯片型号。Apple Silicon 芯片M1、M2、M3 系列要选 arm64 版本的安装包Intel 芯片的 Mac 才选 x64。看芯片型号也很简单点屏幕左上角苹果图标 →关于本机处理器信息里写着 Apple M1 就是 arm64写着 Intel 就是 x64。另外提一个很多教程没讲清楚的点官网下载页还提供了 zip 和 7z 等免安装压缩包。这个压缩包解压之后其实也能用但要自己手动配环境变量对新手来说麻烦且容易出错。除非你已经很熟悉环境变量操作否则第一选择永远是 .msi 或 .pkg 安装包让安装程序帮你处理这些事。2.3 安装前要做的两个小检查确认完版本和安装包类型动手安装之前我建议你做两件小事第一把正在运行的编辑器、IDE、终端窗口全部关掉。Windows 下安装 Node.js 会写环境变量而环境变量的读取是会话级的已经打开的终端不会自动加载新配置你装完后在旧终端里执行node -v可能会提示找不到命令很容易误以为安装失败了。第二如果有旧版本的 Node.js先想清楚要不要共存。有些人电脑上已经装过 Node.js但版本很老或者配置得乱七八糟。处理方式有两种一是进入控制面板的程序列表把旧版卸载干净再装新版二是用 nvm-windows 这类版本管理工具来做多版本共存。对于新手我建议直接卸载旧的装新版干净利落别把时间浪费在版本切换上。3. Windows 全流程图文操作从下载到环境变量配置3.1 官网下载的正确姿势打开 Node.js 官网地址是 nodejs.org。如果你看到的是英文页面没关系按钮位置都是一样的。首页正中间有两个绿色按钮左边那个写着LTS右边那个写着Current点击左侧 LTS 下方的按钮就会自动开始下载 .msi 文件。这里要提醒一个很多教程没提的坑官网默认下载按钮会识别你的操作系统但如果你用的是 Windows 系统点击后下载的可能是 Windows Installer (.msi) 文件。偶尔也会遇到官网访问速度慢、下载中断的情况换个网络环境重试就行不建议去非官方渠道下载安装包避免引入恶意修改的版本。下载完你会得到一个类似node-v20.11.0-x64.msi的文件20.11.0 是版本号x64 是架构。文件体积大概二三十兆不大。3.2 安装向导逐项说明双击 .msi 文件会弹出安装向导整个安装过程其实只需要留意几步。第一步是 License Agreement许可协议勾选 I accept the terms in the License Agreement然后点 Next。第二步选择安装路径默认装在C:\Program Files\nodejs\建议保持默认路径中有 Program Files 没问题后面会用到一个叫 PATH 环境变量的机制这个路径会被写进去别乱改成中文路径或带空格的奇怪路径。第三步进入 Custom Setup 页面这里有一个关键选项Add to PATH一定要确保这个选项被启用。默认情况下它是开启的安装程序会自动把 Node.js 的安装目录加到系统环境变量里这是整个安装过程中最核心的环节。后面几步基本都是 Next、Finish不需要改动任何东西。安装过程一般一分钟左右就完成了。3.3 环境变量配置这块最容易被忽略也最容易出错很多教程把环境变量配置写得像玄学让新手觉得高深莫测其实原理非常简单。Windows 系统里有一个叫 PATH 的查找路径列表。当你在命令行里敲一个命令比如node系统并不是在全盘搜索哪里有 node 程序而是依次在 PATH 里记录的每个目录中查找有没有node.exe。找到了就执行找不到就提示不是内部或外部命令也不是可运行的程序。所以环境变量配置的本质就一句话把 Node.js 的可执行文件目录告诉系统让系统能在任意位置找到 node 命令。用 .msi 安装包安装时勾选了 Add to PATH这个工作安装程序自动帮你做了。安装完后依然建议手动检查一遍确保万无一失。操作步骤是按Win S搜索环境变量打开编辑系统环境变量点击右下角环境变量按钮在系统变量列表中找到Path这一项双击打开编辑窗口在列表里确认是否有C:\Program Files\nodejs\这一项如果你换了安装路径这里对应你自己的路径。如果看到这一项说明环境变量配置成功了。如果没看到点新建把路径加进去保存后重新打开一个终端窗口注意旧终端里配置不会生效。这里有个关键点我反复强调但不嫌多改完环境变量后必须把终端窗口完全关闭再重新打开。环境变量是在终端进程启动时加载的旧窗口根本不知道你新加了配置。很多我明明装好了但 node 还是找不到的问题90% 出在这个环节。3.4 系统环境变量和用户环境变量的区别环境变量设置窗口里有两个区域上面的用户变量只对当前用户生效下面的系统变量对所有用户生效。安装 Node.js 时默认是加到用户变量还是系统变量实操发现 .msi 安装包默认会同时处理但如果你是自己手动添加的建议加到系统变量里这样不管哪个用户登录都能用省得将来因为权限问题出幺蛾子。另外要注意编辑系统变量可能需要管理员权限。如果你在编辑时提示权限不足右键此电脑→属性→高级系统设置用管理员账号操作就行。4. 安装验证与第一个 Node 程序试跑4.1 验证三步走node / npm / 版本信息装完后怎么确认真的装好了重新打开一个终端窗口按Win R输入cmd或者直接搜索命令提示符打开。依次输入下面的命令看是否返回版本号node -v正常情况下会输出类似v20.11.0的结果。如果出现不是内部或外部命令的提示请先回到 3.3 节检查环境变量确认配置无误后再重试。绝大多数验证失败都出在这个环节。npm -vnpm 是 Node.js 自带的包管理工具装 Node.js 时会一起装上。输出类似10.2.4。如果 node 命令正常但 npm 报错有可能是安装包损坏卸载重装一遍往往会解决。node不带任何参数直接输入 node会进入交互式 REPL 环境这是 JavaScript 的交互式解释器光标前面会出现提示符类似于浏览器的控制台。在这里输入1 2回车会输出3说明 Node 环境可以正常执行 JS 代码。输入.exit退出。这三步全部通过恭喜环境已经是好的了。4.2 第一个 Node 程序从创建文件到执行命令行验证没问题还不够建议再走一遍完整的创建文件→编写代码→运行流程把写代码的基本路径打通。在你方便的位置新建一个文件夹比如D:\node-demo在命令行里用cd /d D:\node-demo进入这个目录或者直接在文件夹路径栏输入 cmd 回车可以快速打开定位到该目录的终端。在文件夹里新建一个文本文件命名为hello.js用任何文本编辑器打开并写入console.log(Hello, Node.js!); console.log(当前 Node 版本, process.version);保存后在命令行中执行node hello.js输出结果Hello, Node.js! 当前 Node 版本 v20.11.0到这步你已经完成了一个真正意义上的 Node.js 程序从编写到运行的全流程。4.3 常见验证问题排查清单根据经验新手在这一步最容易碰到下面这些问题直接列个排查对照表现象可能原因解决方法node -v提示不是内部或外部命令环境变量没配上或配错了检查 Path 里是否有 nodejs 目录检查路径是否正确改完重启终端安装时勾了 Add to PATH 但命令无效旧终端窗口未重启全部关闭终端重新打开node -v正常但npm -v报错安装包损坏或残留旧配置卸载重装检查用户目录下是否有旧的 npmrc 文件安装过程提示错误代码 2502/2503系统权限问题以管理员身份运行 cmd再执行 msiexec 安装命令排查的核心逻辑就一个先确认安装目录里有没有node.exe这个文件有的话问题就出在环境变量路径上没有的话就重装。别碰到问题就整台电脑排查定位清晰才能快速解决。5. npm 提速与全局路径管理装完必做的两件事5.1 为什么要改 npm 镜像源Node.js 装好只是万里长征第一步真正天天打交道的是 npm。npm 默认的官方源在国外在国内网络环境下拉包速度不稳定一个小项目动辄几百上千个依赖包用默认源下载可能等得怀疑人生。解决办法是把 npm 的 registry 指向国内镜像源。目前国内维护得比较好的镜像包括淘宝镜像npmmirror同步频率高、稳定性好大部分开发者都在用。换个源的命令很简单npm config set registry https://registry.npmmirror.com设置完之后可以验证一下当前源地址npm config get registry看到输出变成https://registry.npmmirror.com就说明镜像源配置成功了。之后执行npm install下载速度会有非常直观的提升。也许有读者会担心镜像源不权威、有安全风险。这个担心可以放下npmmirror 是定时从 npm 官方仓库全量同步的包的内容和官方一致只是下载节点在国内速度更快。实际用了这么多年稳定性是有保障的。5.2 设置 npm 全局安装路径npm 有两个核心路径一个是全局安装路径决定了npm install -g xxx安装的包放在哪里另一个是全局缓存路径存放下载的缓存文件。默认情况下全局包安装在 Node.js 安装目录下的node_modules文件夹里缓存则在用户目录下的AppData\Local\npm-cache。Windows 下由于系统权限机制有些项目写到默认全局路径时会被拦截还容易出现安装成功但命令找不到的问题所以建议把全局路径单独设置到一个自定义目录。推荐做法是在某个磁盘根目录下建一个nodejs_global文件夹然后执行npm config set prefix D:\nodejs_global npm config set cache D:\nodejs_cache这里的D:\nodejs_global和D:\nodejs_cache可以根据你的实际情况改成其他路径但要注意两点路径中不要含有中文和空格文件夹最好提前手动创建好。设置完执行npm config list会输出当前的 npm 配置列表确认prefix和cache都已经指向你设置的路径。5.3 全局路径配好后环境变量也要跟着改这一步很容易被忽略设置完 npm 全局路径后还需要把这个路径加入环境变量 PATH否则全局安装的工具命令还是找不到。比如你执行npm install -g cnpm安装完成后cnpm 的实际位置在D:\nodejs_global\cnpmWindows 下是cnpm.cmd如果这个目录不在 PATH 里你在命令行输cnpm -v一样提示不是内部或外部命令。操作方法和 3.3 节完全一样在环境变量 Path 中把D:\nodejs_global加进去。记得保存后重新打开终端验证。还有一个经验在自定义全局路径时尽量在命令行用npm config set prefix设置路径而不是去改 npm 的配置文件因为配置文件写错一个字母可能导致所有 npm 命令失效排查起来非常烦人。5.4 验证全局包安装与运行走一遍完整的验证流程npm install -g cnpm安装完成后执行cnpm -v如果能输出版本信息说明全局路径配置全部生效。以后安装任何全局工具比如npm install -g nodemon、npm install -g serve都可以直接用起来。实际使用中cnpm除了下载速度快还能绕开某些包的编译安装问题遇到 npm 装不上的原生模块时换 cnpm 试试往往是有效的解法。6. 进阶体验用 nvm 做多版本管理6.1 为什么要用 nvm很多项目有各自的 Node 版本要求老项目可能锁定在 Node 14新项目要求至少 Node 20你不可能为了切换项目反复卸载重装。这时候就该轮到 nvm 出场了。nvm 全称 Node Version Manager是一个 Node 版本管理工具核心能力有两个一是安装任意版本的 Node.js二是在多个版本之间随时切换。装完之后再也不用因为版本问题把一个环境搞得乱七八糟了。6.2 核心命令一览如果你用的是 Linux 或 macOS直接执行官方安装脚本安装 nvm然后就能用它装 Nodenvm install 20 # 安装 Node 20 最新版 nvm install 18 # 安装 Node 18 最新版 nvm use 20 # 切换到 Node 20 nvm ls # 查看本机已安装的所有版本 nvm alias default 20 # 设置默认版本新开终端默认使用 Node 20Windows 用户要使用 nvm-windows安装方式稍有不同但核心命令类似。nvm-windows 的安装程序会自动帮你配置环境变量这也是我推荐新手接触 nvm 的原因之一它能减少手动配环境变量的出错概率。6.3 nvm 和直接安装怎么选这个问题我经常被问到。我的建议是如果你是前端开发、后端 Node 开发以后会长期和 Node 打交道第一次就装 nvm 用 nvm 来管 Node如果你只是临时跑个脚本、上个课交个作业直接用安装包装一个 LTS 版本就够了。nvm 有一点需要注意它和已安装的 Node.js 不能同时使用同一套环境变量。装了 nvm 后之前直接安装的 Node 路径不要放在 PATH 里否则 nvm 切换版本会乱套。实际操作时最好先把系统里旧的 Node.js 卸载掉再装 nvm从零开始管理。7. 从踩坑中总结的 5 条实操建议最后说说我在实际帮人装环境过程中反复遇到的几个问题都是真实案例提前看到能帮你少交很多学费。第一个是安装路径问题。别把 Node.js 装到带空格或中文的路径里也别自作聪明装到 U 盘或网盘同步目录。有些同步工具会把安装目录的文件同步到云端导致本地文件被锁住或误删到时候各种奇怪报错接踵而至。标准做法就是默认路径或者直接放磁盘根目录下的英文文件夹。第二个是不要混用 npm 和 cnpm 安装项目依赖。同一个项目里有些人装一半用 npm、装一半用 cnpm可能导致 node_modules 结构混乱出现版本对不上包重复这类诡异问题。一个项目尽量只用一种包管理器推荐统一使用配置过镜像源的 npm 即可。第三个是编辑器选对。装完 Node 后你需要一个文本编辑器来写代码推荐 VS Code它内置终端打开终端直接就能用 node 命令体验非常顺滑。注意装完 VS Code 后别忘了重启一下否则内置终端读不到最新环境变量。第四个是别急着装全局包。很多教程会顺手让你安装一些全局工具但实际开发中很多常用工具比如 Vite、Webpack 的 CLI现在都推荐装到项目本地npm install --save-dev而不是全局装。原因很简单项目依赖必须在 package.json 里声明并锁定版本团队成员才能保证使用同样的环境。全局包只建议装那些独立使用、不跟具体项目绑定的工具比如serve、nodemon这类装多了反而是负担。第五个是关于网络环境的判断。如果你在安装某些包时一直报 ECONNRESET 或 ETIMEDOUT 这类网络错误先检查镜像源是否配置成功。大部分装不上包的问题根因不是 npm 本身坏了而是网络到官方源不通。换镜像源后再试绝大多数情况就好了。看完这篇教程你应该已经把 Node.js 从听说过变成了装好且跑通的状态。照着上面的步骤操作整个流程大约只需要十几分钟而且每步都能验证对错不是稀里糊涂装完拉倒。以后遇到任何开发工具的环境配置问题也建议用同样的思路来处理先确认版本选型再安装再验证最后用最小示例跑通。这套方法在 Node.js 上适用换到 Python、Java、Go 也照样管事。