JavaScript服务端入门与Node.js核心解析

本文深入浅出地揭开了JavaScript服务端编程的面纱，明确指出Node.js并非“魔改JS”，而是通过V8引擎执行标准JavaScript、借助libuv实现跨平台异步I/O，将操作系统能力安全封装为fs、path、http等核心模块，真正让JS脱离浏览器束缚、直面文件系统与网络——同时直击新手高频痛点：模块系统混用导致的require未定义、路径拼接引发的Windows兼容问题、阻塞式fs操作拖垮服务、http底层API误用造成连接挂起等实战陷阱，并给出清晰可行的解决方案与最小可运行示例，帮助开发者从“能跑”迈向“跑得稳、写得对、调得准”。

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 就等于能用”，结果在路径处理或异步流程上栽跟头。

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 每次都重新执行，其实它被缓存了。

到这里，我们也就讲完了《JavaScript服务端入门与Node.js核心解析》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！