这次我们来看一个老牌但绕不开的话题Node.js 入门。市面上的 Node.js 教程很多但大部分要么讲得太散要么默认你已经有了一整套可用的开发环境。本文换一个思路按 1 小时能跑完的节奏从零开始下载安装 Node.js、验证环境、用内置模块写一个最小 Web 服务再用 Express 把 Web 应用搭起来最后通过接口验证整个流程。整个过程不需要 GPU不需要大型开发环境只需要一台能装普通软件的电脑、一个编辑器和一个浏览器。先说结论Node.js 不是一个框架也不是一门新语言它是一个基于 Chrome V8 引擎的 JavaScript 运行时让 JavaScript 可以脱离浏览器在服务端运行。它最核心的三个特点是事件驱动、非阻塞 I/O、自带 npm 包管理器。因为是事件驱动它在处理大量网络请求时可以用较少的系统资源承载较高的并发因为自带 npm你可以用一行命令安装几十万个第三方模块Web 服务、接口、自动化脚本、工具链都非常容易拼出来。更关键的是前后端用同一种语言对前端开发者来说这是最平滑的一条后端学习路径。本文将按 10 个章节展开带读者完成下面这些实操安装 Node.js LTS 并验证用 nvm 做多版本管理配置 npm 镜像用内置 http 模块写出第一个能访问的页面用 Express 搭建带路由的 Web 应用用 curl 和浏览器验证 GET/POST 接口观察 Node 进程的资源占用把常见的安装报错和运行报错逐个排查掉。最终你会得到一套可以继续扩展的 Node.js Web 应用骨架。1. Node.js 核心能力速览先把核心能力整理成一张表方便快速判断该不该继续往下看能力项说明技术类型JavaScript 运行时 / 服务端开发环境核心组件Chrome V8 引擎、内置模块、npm主要能力HTTP Web 服务、REST API、静态文件服务、CLI 工具、自动化脚本支持平台Windows、Linux、macOS较新的 LTS 版本建议在 64 位系统上使用硬件要求常规 CPU 和内存即可不需要 GPU安装体积官网安装包通常几十 MB 级别实际占用以官网说明为准包管理npm可配置镜像源加速安装版本管理nvm / nvm-windows 多版本切换推荐学习组合Node.js LTS VS Code npm Express典型场景Web 后端 API、前端工具链、脚本自动化、实时通信这里要重点说明的是Node.js 本身没有“显存”这类概念它是一个纯 CPU/内存型运行时。普通课程实验、本地 Web 应用、接口调试对电脑配置要求很低。哪怕是一台嵌入式开发板或者低配云服务器也可以安装并运行 Node.js 服务。这也是它作为入门技术栈的优势。从版本选择来看官网一般会区分 LTS 和 Current 两个版本。LTS 是长期维护版适合生产环境和稳定学习Current 包含最新特性但更新节奏更快。对于本教程建议安装 LTS。如果读者需要同时维护多个项目或者某些项目对 Node 版本有硬性要求可以采用 nvm 来做版本切换这一点会在第 4 章详细演示。2. Node.js 能做什么适用场景与学习边界Node.js 适合这些人想补后端知识的前端开发准备做全栈项目但希望用同一种语言的学生需要快速搭一个接口原型或自动化脚本的测试、运维同学。它解决的核心问题是让 JavaScript 从浏览器走到服务器端。前端开发写的语言后端能继续用前端工程师既写页面又写接口团队沟通成本会低很多。具体到 Web 开发Node.js 可以用内置 http 模块直接提供 HTTP 服务也可以用 Express、Koa、Fastify 这类框架快速组织路由和中间件。除了 Web 服务Node.js 在现代化前端工具链里也是基础依赖Vite、Webpack、Tailwind CLI 等都依赖 Node.js 环境。换句话说即使你现在只写前端后端项目也不用只要用到这些构建工具本机仍然需要一个可用的 Node.js尤其是近年来前端脚手架对 Node 版本的最低要求越来越高经常出现提示 “a later version of Node.js is required” 的情况原因就是本机版本太老。但它也有限制。Node.js 默认是单线程事件循环适合高 I/O、高并发的网络请求却不适合纯粹的 CPU 密集型计算任务。比如海量图片处理、视频转码、复杂数据结构运算直接在主线程里跑会把事件循环阻塞导致其他请求排队。这类任务通常需要 Worker Threads、消息队列或者直接用 Go、Rust、C 等更合适的方案实现。另外Node.js 生态虽然丰富但很多能力来自第三方 npm 包使用前需要关注包来源、许可证、漏洞历史生产环境要定期执行npm audit做安全检查。涉及用户数据、密钥、版权素材的功能要明确授权边界不要把敏感信息写进代码或提交到公开仓库。3. Node.js 安装前的环境准备安装 Node.js 之前先确认三件事操作系统、旧版本残留、编辑器。本教程以 Windows 为主要演示环境但 Linux 和 macOS 的安装思路完全一致差别只在于版本切换工具不同。建议使用 Windows 10/11 的 64 位系统因为最新 LTS 版本对旧系统支持有限。从材料来看很多用户尝试在 Windows 7 上安装新版 Node.js会有兼容性问题更容易遇到后续 npm 包无法运行的情况如果还在使用老系统更稳妥的判断是优先升级系统或只使用旧版 Node.js但要接受新依赖不兼容和安全风险。第二检查本机是否已经安装过 Node.js。打开终端执行node -v npm -v如果两条命令都能正常打印版本号说明环境已存在。这里要区分一个常见误区系统里有很多软件会自带 Node.js 环境比如部分桌面客户端、前端脚手架它们内置的 Node 是给自身运行用的不一定会注册到全局 PATH。如果你运行某个工具时提示node.js not found (please save below and restart)通常不是说你没装 Node而是该工具在当前 PATH 里找不到全局 Node需要先把 Node 装好并把它加入环境变量再重启工具。第三安装编辑器。VS Code 是免费且社区插件齐全的选择装好后安装 Chinese Language Pack、ES7 React/React Native snippets 等扩展即可。如果暂时不想安装额外编辑器用系统自带记事本也能完成本教程但体验会差一些不推荐。最后整理磁盘空间和端口。Node.js 安装包很小普通项目依赖也只在几百 MB 级别不需要特殊准备磁盘。端口方面本教程会使用 3000 端口启动前可以先用命令检查 3000 端口是否被占用netstat -ano | findstr :3000如果有输出说明端口被其他程序占用可以换用 3001 或其他空闲端口。4. Node.js 安装与版本管理从零到可用4.1 方法一官网直接安装最简单的安装方式是访问 Node.js 官网 nodejs.org下载 LTS 版安装包。下载完成后双击安装一路 Next在安装到选择组件那一步时确认Add to PATH已经被勾选这一步非常关键。很多新手装完执行node -v提示“不是内部或外部命令”原因就是没有加入 PATH或者安装后没有重开终端。安装完成后新开一个终端窗口执行node -v npm -v能同时看到两个版本号说明环境已经可用。如果出现“无法将 node 识别为 cmdlet、函数、脚本文件”之类的提示先重启终端再试如果仍然不行检查 Windows 环境变量里的 PATH 是否包含 Node.js 安装目录。4.2 方法二用 nvm 管理多版本如果读者手里有多个项目不同项目要求的 Node 版本不一样推荐用 nvm 或 nvm-windows 管理版本。这种方式的好处是先安装一个统一的 nvm 管理工具再通过命令安装任意版本的 Node.js随时切换不用反复卸载安装。这类场景在实际开发里非常典型比如有人执行nvm install 22.13.1后一直停在Downloading node.js version 22.13或者执行nvm install 24.19.0时提示Node.js v24.19.0 is not yet released or is not available这些问题大多和网络或版本号有关排查方式在常见问题章节会展开。安装 nvm 后打开终端执行nvm list available先看远程有哪些版本可用。以 Node.js 22 为例安装和切换命令如下nvm install 22 nvm use 22执行node -v确认当前已经是目标版本。如果某个项目需要切换到 Node.js 20nvm install 20 nvm use 20nvm 会在不同版本之间切换全局 PATH 中的 node 指向比较适合做版本回归测试。如果 nvm 下载 Node.js 时一直卡住可以在 nvm 安装目录下的 settings.txt 里配置镜像源node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/配置完成后重新执行 nvm install一般可以明显提升下载速度。需要注意不同版本 nvm 对配置项的解析可能有差异如果配置文件不生效建议去对应项目文档确认当前版本的配置格式不要盲目照抄。4.3 配置 npm 镜像安装完 Node.js 后npm 默认访问