当前位置：首页 > news >正文

【前端】Node.js 简易服务器搭建全指南：从基础到实践

news 2025/8/6 8:40:50

Node.js 简易服务器搭建全指南：从基础到实践

Node.js 作为一个基于 Chrome V8 引擎的 JavaScript 运行环境，让开发者可以使用 JavaScript 构建后端服务。本文将详细讲解如何从零开始搭建一个简单的 Node.js 服务器，并实现基本的路由功能和静态文件访问。

点击观看教学：

如何使用 Node.js 命令搭建一个服务器

在这里插入图片描述

准备工作

在开始之前，确保你的开发环境满足以下要求：

安装 Node.js：访问 Node.js 官网下载并安装适合你操作系统的版本（建议选择 LTS 长期支持版）
代码编辑器：推荐使用 VS Code、WebStorm 等现代编辑器
终端工具：用于执行命令（Windows 可使用 PowerShell 或命令提示符，Mac/Linux 使用终端）

安装完成后，可通过以下命令验证安装是否成功：

node -v  # 显示 Node.js 版本
npm -v   # 显示 npm 包管理器版本

第一步：创建项目结构

新建项目文件夹，例如 node-server-demo

打开终端，进入该文件夹：

mkdir node-server-demo
cd node-server-demo

初始化项目（可选但推荐）：
```
npm init -y
```
这个命令会创建一个 package.json 文件，用于管理项目依赖和配置。

第二步：编写基础服务器代码

在项目文件夹中创建 server.js 文件
编写最基础的服务器代码：

代码解析：

http 模块是 Node.js 内置的 HTTP 服务器模块，无需额外安装
createServer() 方法创建服务器实例，接收一个回调函数处理请求
回调函数的两个参数：
- req（request）：请求对象，包含客户端发送的信息
- res（response）：响应对象，用于向客户端返回数据
res.writeHead() 用于设置 HTTP 响应头
res.end() 用于发送响应主体并结束本次响应
server.listen() 启动服务器并监听指定端口

第三步：运行服务器并测试

在终端中执行以下命令启动服务器：
```
node server.js
```
打开浏览器，访问 http://localhost:3000，你应该能看到页面上显示 “Hello, Node.js 服务器！”
停止服务器可在终端中按 Ctrl + C

第四步：实现路由功能

路由是指根据不同的 URL 路径返回不同的内容。我们可以通过解析请求的 URL 来实现这一功能：

现在你可以访问以下路径测试路由功能：

http://localhost:3000 - 首页
http://localhost:3000/about - 关于页面
其他任意路径 - 404 页面

第五步：添加静态文件访问功能

通常我们希望服务器能返回 HTML 文件而不是硬编码的 HTML 字符串。我们可以使用 fs 模块读取文件系统中的 HTML 文件：

首先在项目根目录创建 index.html 文件：

<!DOCTYPE html>
<html>
<head><meta charset="UTF-8"><title>首页</title>
</head>
<body><h1>欢迎来到我的网站</h1><p>这是通过 Node.js 服务器提供的静态 HTML 文件</p><a href="/about">访问关于页面</a>
</body>
</html>

修改 server.js 代码以支持读取静态文件：

代码解析：

引入了 fs 模块（文件系统）用于读取文件
引入了 path 模块用于处理文件路径，确保在不同操作系统上路径都能正确解析
path.join(__dirname, 'index.html') 构建了 index.html 文件的完整路径，__dirname 表示当前脚本所在目录
fs.readFile() 异步读取文件内容，在回调函数中处理读取结果
增加了错误处理，如果文件不存在或读取失败，返回友好的错误信息

常见问题与解决方案

中文乱码问题
- 解决方案：在响应头中指定字符编码 charset=utf-8
“Cannot write headers after they are sent” 错误
- 原因：对同一个请求多次发送响应头
- 解决方案：确保每个请求只调用一次 res.writeHead() 和 res.end()
文件找不到错误
- 检查文件路径是否正确
- 确保文件确实存在于指定位置
- 使用 path 模块处理路径，避免手动拼接路径字符串