Node.js是基于Chrome V8引擎的服务器端JavaScript运行时，采用事件驱动、非阻塞I/O模型；与浏览器JS共用语法但全局对象（global替代window）、API（无DOM）和模块系统（CommonJS默认，ESM需配置）不同。
Node.js 不是 JavaScript 的某种“升级版”或“新语法”，它是让 JavaScript 能在服务器上运行的运行时环境——核心是 Chrome V8 引擎 + 事件驱动、非阻塞 I/O 模型。
Node.js 和浏览器 JS 的关键区别在哪
浏览器里 JS 主要操作 DOM、处理用户交互；Node.js 则提供文件系统（fs）、网络（http、https）、进程（process）、模块加载（require / import）等服务端能力。两者共用同一套语言语法，但全局对象不同：window 在 Node.js 里不存在，替换成 global；document、alert 等浏览器专属 API 无法直接使用。
- 模块系统默认是 CommonJS（
require()/module.exports），ESM（import/export）需显式启用（如加"type": "module"到package.json） - 没有事件循环的“宏任务/微任务”调度差异，但 I/O 回调全部走 libuv 的线程池或操作系统异步接口，不是靠定时器模拟
- 单线程 + 异步非阻塞是默认行为，但 CPU 密集型任务（如大数组排序、图像处理）会阻塞主线程，需用
worker_threads或子进程隔离
用原生 http 模块快速启动一个后端服务
不依赖任何框架，
仅用 Node.js 内置模块就能响应 HTTP 请求。适合理解底层机制，但生产环境一般不用它直接写业务逻辑。
const http = require('http');
const url = require('url');
const server = http.createServer((req, res) => {
const parsedUrl = url.parse(req.url, true);
if (req.method === 'GET' && parsedUrl.pathname === '/api/hello') {
res.writeHead(200, { 'Content-Type': 'application/json' });
res.end(JSON.stringify({ message: 'Hello from Node.js!' }));
} else {
res.writeHead(404);
res.end('Not Found');
}
});
server.listen(3000, () => {
console.log('Server running on http://localhost:3000');
});
-
http.createServer()返回的是一个Server实例，必须显式调用.listen()才真正绑定端口 -
req.url是原始路径字符串（含查询参数），需要用url.parse(req.url, true)解析成带query对象的结构 - 每次响应都必须手动设置状态码（
res.writeHead()）和结束响应（res.end()），漏掉任一环节会导致请求挂起
为什么实际项目几乎都用 Express 或 Fastify
原生 http 模块太底层：路由要自己匹配、JSON 解析要手动 req.on('data') + JSON.parse()、错误处理没中间件、CORS / 静态文件 / Body 解析全得手写。Express 提供了简洁的路由定义和中间件链；Fastify 更侧重性能与类型支持（基于 Schema 自动生成序列化逻辑）。
- Express 示例中
app.get('/user/:id', ...)自动提取req.params.id，无需正则匹配路径 - Body 解析需额外中间件：
app.use(express.json())和app.use(express.urlencoded({ extended: true })) - Fastify 默认用
fast-json-stringify加速响应序列化，但要求你声明schema.response，否则回退到JSON.stringify - 二者都不处理数据库连接、JWT 签发、日志聚合等，这些要靠生态包（如
pg、jsonwebtoken、pino）组合
常见踩坑点：模块导入、ESM 与 CommonJS 混用
Node.js 14+ 默认支持 ESM，但混合使用 require() 和 import 极易出错。最典型的报错是：ReferenceError: require is not defined in ES module scope 或 Cannot use import statement outside a module。
- 如果
package.json里写了"type": "module"，所有.js文件按 ESM 解析，此时不能用require()，必须改用import fs from 'fs'（注意：部分内置模块如fs需从fs/promises导入才能获得 Promise 版本） - 想在 ESM 中动态加载 CommonJS 模块（比如某些老库只导出
module.exports），要用await import('./legacy-lib.cjs')，不能用require() -
__dirname和__filename在 ESM 中不可用，应改用import { dirname } from 'path'; import { fileURLToPath } from 'url'; const __dirname = dirname(fileURLToPath(import.meta.url));
真正难的不是启动服务，而是设计请求生命周期：如何统一处理错误、校验输入、注入依赖、记录 trace ID、安全地拼接 SQL 查询——这些 Node.js 本身不管，得靠你选的框架和配套工具链来组织。别急着封装“通用 controller”，先确保每个接口能正确返回 4xx/5xx 状态码并带上可读错误信息。
