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 和锁文件。
node --version
npm --version
mkdir express-hello
cd express-hello
npm init -y
npm install express
npm ls express --depth=0预期结果(只列关键输出,版本号与安装路径会因环境不同而变化):
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 覆盖,部署到不同环境时不必改源码。
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}`);
});运行程序:
node app.js预期输出:
Listening on http://localhost:3000终端保持运行状态时,再开一个终端请求首页:
curl http://localhost:3000/预期输出:
Hello Expressexpress() 返回的 app 是应用对象;app.get() 把 GET / 与处理函数绑定;app.listen() 才真正开始监听 TCP 端口。开发时通常只调用一次 app.listen(),其他 URL 继续注册到同一个 app 上。
检查启动失败和端口占用
如果启动时报 EADDRINUSE,表示目标端口已经被其他进程监听。最直接的修复是停止占用者,或者临时换一个端口;因为示例读取 PORT,无需修改 app.js。
PORT=3001 node app.js预期输出:
Listening on http://localhost:3001在 Windows PowerShell 中,等价做法是先执行 $env:PORT = 3001,再执行 node app.js。若终端显示已监听但浏览器仍访问失败,先确认访问的是同一个端口,并保持启动进程没有退出;本机开发时应先用 http://localhost:<PORT> 验证,再处理代理、防火墙或外部网络问题。