Node.js / 系统课时

创建 Express 应用

创建 Express 应用

这一课把一个空目录变成可访问的 Express Web 服务:先检查 Node.js 与 npm,安装 Express,再创建应用实例、注册首页路由并监听端口,最后用浏览器或 curl 验证响应。以下示例以 Express 5.x 为准。

学习目标

  • 使用 npm 初始化项目并安装 Express 5.x。
  • 用 express() 创建应用实例,并通过 app.listen() 启动 HTTP 服务。
  • 能验证服务是否可访问,并定位最常见的端口占用问题。

检查环境并安装 Express

Express 5.x 要求 Node.js 18 或更高版本。先确认 node 与 npm 可用,再创建独立目录并安装依赖;不要把示例直接装进已有项目,以免修改原项目的 package.json 和锁文件。

bash
node --version
npm --version
mkdir express-hello
cd express-hello
npm init -y
npm install express
npm ls express --depth=0

预期结果(只列关键输出,版本号与安装路径会因环境不同而变化):

text
v<MAJOR>.<MINOR>.<PATCH>
<MAJOR>.<MINOR>.<PATCH>
express-hello@1.0.0 <PATH>
└── express@<VERSION>

安装完成后,项目至少应有 package.json、package-lock.json 和 node_modules。其中 package.json 记录 Express 依赖,锁文件记录本次解析到的精确依赖版本,node_modules 保存实际安装内容。

创建应用实例并启动服务

在项目根目录新建 app.js。下面的程序只保留创建应用、定义路由、监听端口三个必要动作;端口允许通过环境变量 PORT 覆盖,部署到不同环境时不必改源码。

js
const express = require('express');

const app = express();
const PORT = Number(process.env.PORT ?? 3000);

// 路由必须给请求一个响应,否则连接会一直等待。
app.get('/', (req, res) => {
  res.send('Hello Express');
});

app.listen(PORT, (error) => {
  if (error) {
    console.error(error.code ?? error.message);
    process.exitCode = 1;
    return;
  }
  console.log(`Listening on http://localhost:${PORT}`);
});

运行程序:

bash
node app.js

预期输出:

text
Listening on http://localhost:3000

终端保持运行状态时,再开一个终端请求首页:

bash
curl http://localhost:3000/

预期输出:

text
Hello Express

express() 返回的 app 是应用对象;app.get() 把 GET / 与处理函数绑定;app.listen() 才真正开始监听 TCP 端口。开发时通常只调用一次 app.listen(),其他 URL 继续注册到同一个 app 上。

检查启动失败和端口占用

如果启动时报 EADDRINUSE,表示目标端口已经被其他进程监听。最直接的修复是停止占用者,或者临时换一个端口;因为示例读取 PORT,无需修改 app.js。

bash
PORT=3001 node app.js

预期输出:

text
Listening on http://localhost:3001

在 Windows PowerShell 中,等价做法是先执行 $env:PORT = 3001,再执行 node app.js。若终端显示已监听但浏览器仍访问失败,先确认访问的是同一个端口,并保持启动进程没有退出;本机开发时应先用 http://localhost:<PORT> 验证,再处理代理、防火墙或外部网络问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 Express 应用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通