Node.js Web 模块（保姆级教程）

Node.js Web 模块：从零开始构建你的第一个 Web 服务

在现代前端与后端开发的交汇点上，Node.js 早已成为不可忽视的存在。它让 JavaScript 不再局限于浏览器，而是可以运行在服务器端，构建高性能的网络应用。而其中的核心能力之一，就是 Node.js Web 模块 的使用与管理。

想象一下，你正在搭建一座城市。街道、建筑、水电系统，都需要分工协作。Node.js 就像这座城市的“总控中心”，而 Web 模块就是那些负责不同功能的“功能单元”——比如处理用户请求、读取文件、连接数据库。每个模块各司其职，通过统一的接口相互通信。

如果你是初学者，可能会觉得“模块”这个概念有点抽象。别担心，我们接下来就用最贴近现实的方式，一步步带你理解 Node.js Web 模块的本质。

什么是 Node.js Web 模块？

在 Node.js 中，模块（Module）是封装了特定功能的独立代码单元。你可以把它理解为一个“功能盒子”——你不需要知道内部如何运作，只需要知道它能做什么。

Node.js 的模块系统基于 CommonJS 规范，所有模块默认使用 module.exports 导出内容，用 require() 引入。

比喻：就像你在厨房里用不同的调味料盒子。每个盒子（模块）装一种调料（功能），你只需要打开对应的盒子，取出需要的调料，就能完成烹饪。

核心特点

每个文件就是一个模块
模块之间通过 require() 和 module.exports 通信
模块具有作用域隔离，避免变量污染

如何创建和使用 Web 模块

我们来创建一个简单的 Web 服务，演示模块是如何协作的。

创建基础服务器

新建一个文件 server.js，写入以下代码：

// 引入内置的 http 模块，用于创建 HTTP 服务器
const http = require('http');

// 创建服务器实例，监听端口 3000
const server = http.createServer((req, res) => {
  // 设置响应头：告知浏览器返回的是 HTML 文本
  res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });

  // 发送响应内容
  res.end('<h1>欢迎访问我的 Node.js Web 服务！</h1>');
});

// 启动服务器，监听 3000 端口
server.listen(3000, () => {
  console.log('服务器已启动，访问 http://localhost:3000');
});

注释说明：

require('http')：引入 Node.js 内置的 http 模块，它是构建 Web 服务的基础。

createServer()：创建一个 HTTP 服务器，接收请求和响应。

listen(3000)：让服务器在本地 3000 端口等待请求。

运行命令启动服务：

node server.js

打开浏览器访问 http://localhost:3000，就能看到页面内容。

模块化拆分：让代码更清晰

当前代码虽然能运行，但逻辑都挤在 server.js 里。随着功能增多，代码会变得难以维护。

这时，我们就需要使用 Node.js Web 模块 来拆分职责。

创建路由模块

新建一个文件 router.js，用来处理不同路径的请求：

// router.js：定义路由规则，将不同 URL 映射到不同处理函数

// 导出一个函数，接收请求和响应对象
module.exports = function route(req, res) {
  // 根据请求路径，返回不同内容
  if (req.url === '/') {
    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
    res.end('<h1>首页</h1><p>欢迎回来！</p>');
  } else if (req.url === '/about') {
    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
    res.end('<h1>关于页面</h1><p>这是关于我的介绍。</p>');
  } else {
    // 其他路径返回 404
    res.writeHead(404, { 'Content-Type': 'text/html; charset=utf-8' });
    res.end('<h1>404 页面未找到</h1>');
  }
};

更新主服务器文件

修改 server.js，引入 router.js：

// server.js：主入口文件，引入路由模块并使用

// 引入自定义的路由模块
const route = require('./router');

// 引入内置的 http 模块
const http = require('http');

// 创建服务器
const server = http.createServer((req, res) => {
  // 调用路由模块处理请求
  route(req, res);
});

// 启动服务
server.listen(3000, () => {
  console.log('服务器已启动，访问 http://localhost:3000');
});

这样，主文件只负责“分发请求”，而具体的逻辑由 router.js 负责。这正是 Node.js Web 模块 的核心价值：职责分离，便于维护。

模块之间的依赖与通信

模块之间如何“对话”？靠的是 exports 和 require。

导出多个功能

你可以导出多个函数或变量。例如，创建一个 utils.js 工具模块：

// utils.js：提供常用工具函数

// 导出一个函数：获取当前时间
exports.getCurrentTime = () => {
  return new Date().toLocaleString();
};

// 导出一个变量：网站名称
exports.siteName = '我的 Node.js 网站';

// 导出一个对象：包含多个工具
exports.helper = {
  formatDate(date) {
    return date.toISOString().split('T')[0];
  },
  isValidEmail(email) {
    const regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
    return regex.test(email);
  }
};

在其他模块中使用

在 server.js 中引入并使用：

// 引入工具模块
const utils = require('./utils');

// 使用导出的函数
console.log('当前时间：', utils.getCurrentTime());

// 使用导出的对象
console.log('网站名称：', utils.siteName);
console.log('格式化日期：', utils.helper.formatDate(new Date()));
console.log('邮箱是否合法：', utils.helper.isValidEmail('test@example.com'));

这种方式让你可以构建“工具库”，在多个模块中复用代码，大幅提升开发效率。

Node.js 内置模块与第三方模块

Node.js 提供了丰富的内置模块，比如 fs（文件系统）、path（路径处理）、url（URL 解析）等。

使用 fs 模块读取文件

创建一个 data.json 文件，内容如下：

{
  "name": "小明",
  "age": 25,
  "city": "北京"
}

在 server.js 中读取并响应：

const fs = require('fs');  // 引入文件系统模块

const server = http.createServer((req, res) => {
  if (req.url === '/data') {
    // 异步读取文件
    fs.readFile('./data.json', 'utf8', (err, data) => {
      if (err) {
        res.writeHead(500, { 'Content-Type': 'text/plain' });
        res.end('读取文件失败');
        return;
      }
      res.writeHead(200, { 'Content-Type': 'application/json' });
      res.end(data);  // 返回 JSON 数据
    });
  } else {
    res.writeHead(200, { 'Content-Type': 'text/html' });
    res.end('<p>访问 /data 查看 JSON 数据</p>');
  }
});

server.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000');
});

注释说明：

fs.readFile 是异步操作，避免阻塞主线程。

使用 'utf8' 编码确保中文正常显示。

响应头设置为 application/json，告知浏览器这是 JSON 数据。

实战：构建一个简单的博客系统

我们来整合前面的知识，创建一个简单的静态博客服务。

项目结构

blog-app/
├── server.js
├── router.js
├── posts/
│   ├── post1.md
│   └── post2.md
└── public/
    └── style.css

读取文章内容

在 router.js 中加入文章读取逻辑：

const fs = require('fs');
const path = require('path');

// 定义文章目录
const postsDir = path.join(__dirname, 'posts');

module.exports = function route(req, res) {
  if (req.url === '/') {
    // 列出所有文章
    fs.readdir(postsDir, (err, files) => {
      if (err) {
        res.writeHead(500, { 'Content-Type': 'text/plain' });
        res.end('读取文章失败');
        return;
      }
      const html = `
        <h1>博客文章列表</h1>
        <ul>
          ${files.map(file => `<li><a href="/post/${file}">${file}</a></li>`).join('')}
        </ul>
      `;
      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
      res.end(html);
    });
  } else if (req.url.startsWith('/post/')) {
    const fileName = req.url.slice(5); // 去掉 /post/
    const filePath = path.join(postsDir, fileName);

    fs.readFile(filePath, 'utf8', (err, content) => {
      if (err) {
        res.writeHead(404, { 'Content-Type': 'text/html' });
        res.end('<h1>文章未找到</h1>');
        return;
      }
      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
      res.end(`<h1>${fileName}</h1><pre>${content}</pre>`);
    });
  } else {
    res.writeHead(404, { 'Content-Type': 'text/html' });
    res.end('<h1>页面不存在</h1>');
  }
};

运行服务后，访问 http://localhost:3000，即可看到文章列表，点击链接可查看具体内容。

总结与建议

通过本篇文章，我们系统地学习了 Node.js Web 模块 的核心概念与实践方法。从最基础的 http 模块，到模块化拆分、工具封装、文件读取，再到构建一个小型博客系统，每一步都体现了模块化开发的强大优势。

关键点回顾

每个文件都是一个独立模块，通过 require() 和 module.exports 通信
模块化让代码更清晰、可维护、可复用
合理使用内置模块（如 fs、path）能极大提升开发效率
模块是构建复杂 Web 应用的基础，掌握它，你就迈出了后端开发的第一步

给初学者的建议

不要一上来就用框架（如 Express），先理解原生 Node.js 模块
多写小 demo，比如天气查询、用户登录、文件上传
善用 console.log 调试，理解模块加载顺序和作用域

未来的 Web 开发，离不开对底层机制的理解。而 Node.js Web 模块，正是你通往更高层次的起点。

现在，是时候打开你的编辑器，亲手写一个属于你的 Web 服务了。