Node.js 入门:使用 Express 搭建 Web 服务器

Express 是 Node.js 中最流行的 Web 框架,用于快速构建高效、可扩展的服务器。它简化了路由、中间件和请求处理等核心功能。下面我将一步步指导你搭建一个基本的 Web 服务器。整个过程基于 Node.js 环境,确保你已安装 Node.js 和 npm(Node 包管理器)。如果尚未安装,请先访问 Node.js 官网 下载安装。

步骤 1: 创建项目目录并初始化

首先,创建一个新项目目录,并在其中初始化 npm 项目。打开终端(或命令提示符),执行以下命令:

mkdir express-server
cd express-server
npm init -y

这将生成一个 package.json 文件,用于管理项目依赖。

步骤 2: 安装 Express

在项目目录中,安装 Express 框架:

npm install express

这会将 Express 添加到 package.json 的依赖项中。

步骤 3: 编写服务器代码

创建一个名为 server.js 的文件,并添加以下代码。代码使用 Express 设置一个简单服务器,监听根路径(/)并返回 "Hello World!":

// 导入 Express 模块
const express = require('express');
// 创建 Express 应用实例
const app = express();
// 设置服务器端口号(默认为 3000)
const port = 3000;

// 定义根路径的路由处理
app.get('/', (req, res) => {
  res.send('Hello World!');
});

// 启动服务器,监听指定端口
app.listen(port, () => {
  console.log(`服务器已启动,访问地址:http://localhost:${port}`);
});

  • 关键点解释
    • const app = express();:初始化 Express 应用。
    • app.get('/', ...):处理 HTTP GET 请求到根路径。
    • res.send(...):向客户端发送响应文本。
    • app.listen(port, ...):绑定服务器到指定端口,并输出日志。
步骤 4: 运行服务器

在终端中,执行以下命令启动服务器:

node server.js

如果成功,你将看到输出:服务器已启动,访问地址:http://localhost:3000

步骤 5: 测试服务器

打开浏览器,访问 http://localhost:3000。页面应显示 "Hello World!",表示服务器运行正常。你也可以使用工具如 curl 测试:

curl http://localhost:3000

输出应为 Hello World!

扩展功能:添加更多路由

Express 支持多路由处理。修改 server.js,添加一个新路径 /about

// 在现有代码后添加以下部分
app.get('/about', (req, res) => {
  res.send('关于我们:这是一个 Express 入门示例');
});

重启服务器后,访问 http://localhost:3000/about 即可看到新内容。

常见问题排查
  • 端口冲突:如果端口 3000 被占用,修改 port 变量为其他值(如 8080)。
  • 依赖错误:确保 node_modules 目录存在,或重新运行 npm install
  • 代码错误:检查语法,如括号匹配或拼写错误。
下一步建议
  • 学习中间件:Express 的 app.use() 可用于添加日志、身份验证等中间件。
  • 连接数据库:集成 MongoDB 或 MySQL 存储数据。
  • 部署服务器:使用 PM2 或 Docker 部署到云服务(如 AWS 或 Heroku)。

通过这个示例,你已经掌握了 Express 的基本用法。Express 文档是深入学习的好资源: Express 官方文档。如有疑问,可随时提供更多细节,我会进一步协助!

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐