Node.js使JavaScript服务端编程成为现实，它通过C++底层（libuv、V8）封装系统能力，提供fs、path、http等核心模块及CommonJS/ESM双模块系统，但二者不可混用。
JavaScript服务端编程不是“可能性”问题，而是已经落地多年、被大量生产系统验证的现实——Node.js 就是那个让 JavaScript 脱离浏览器、直接操作文件、网络、进程的运行时。
为什么 Node.js 能跑在服务端，而不是靠“魔改 JS”？
它不改变 JavaScript 语言本身，而是提供了一套 C++ 编写的底层能力（通过 libuv 做异步 I/O，用 V8 执行 JS），再把操作系统接口封装成 JS 可调用的模块。所以你写的还是 const fs = require('fs')，但背后是真实的文件读写系统调用。
关键点：
-
require()不是浏览器原生语法，是 Node.js 实现的模块加载机制 -
global对象替代了浏览器里的window，提供process、__dirname等服务端专属变量 - 没有
document或localStorage—— 这些在服务端根本不存在，强行访问会报ReferenceError: document is not defined
最常被误用的三个核心模块：fs、path、http
新手常以为“能 require 就等于能用”，结果在路径处理或异步流程上栽跟头。
立即学习“Java免费学习笔记（深入）”；
fs 模块：
- 优先用
fs.promises（如fs.promises.readFile()）而非回调版fs.readFile()，避免回调地狱 -
fs.readFileSync()会阻塞整个事件循环，哪怕只读一个配置文件，在高并发场景下也可能拖垮服务
path 模块：
- 永远用
path.join(__dirname, 'data', 'config.json')拼接路径，别用字符串拼接__dirname + '/data/config.json'—— Windows 下会出\导致路径错误 -
__filename和__dirname是 Node.js 注入的全局变量，只在普通 .js 文件里有效；ESM 模式（type: "module"）下需改用import.meta.url
http 模块：
- 它非常底层，连路由、解析 POST body 都要自己写；生产环境几乎没人直接用它，而是选
express、fastify或hono - 忘记调用
res.end()或res.send()会导致连接挂起，客户端一直等待
常见错误：ESM 与 CommonJS 混用导致的 require is not defined
Node.js 14+ 默认支持两种模块系统，但它们不能混用：require() 是 CommonJS 的，import 是 ESM 的。一旦你在 type: "module" 的项目里写 require('fs')，就会报错。
解决方法只有两个明确路径：
- 统一用 CommonJS：删掉
package.json里的"type": "module"，所有文件用require()和module.exports - 统一用 ESM：保留
"type": "module"，把require改成import fs from 'fs'（注意：Node.js 的内置模块如fs、path都已支持 ESM 导入） - 如果必须动态加载（比如插件系统），ESM 下要用
await import('./plugin.js')，不是require()
没有第三条路，也没有“自动转换”——Node.js 不做兼容层，这点和前端打包器完全不同。
HTTP 服务最小可运行示例（CommonJS 版）
下面这段代码能直接 node server.js 启动，不需要任何依赖：
const http = require('http');
const fs = require('fs').promises;
const server = http.createServer(async (req, res) => {
if (req.method === 'GET' && req.url === '/') {
try {
const html = await fs.readFile('./index.html', 'utf8');
res.writeHead(200, { 'Content-Type': 'text/html' });
res.end(html);
} catch (err) {
res.writeHead(404);
res.end('Not Found');
}
} else {
res.writeHead(404);
res.end('Route not handled');
}
});
server.listen(3000, () => {
console.log('Server running on http://localhost:3000');
});
真正卡住人的往往不是语法，而是对 process 生命周期、event loop 阶段、模块缓存机制这些底层行为缺乏感知——比如改了代码却没重启进程，或者以为 require 每次都重新执行，其实它被缓存了。
