en/support/tutorials/express-tutorial

🎉 Express.js Tutorial

Express.js 是一个基于 Node.js 的轻量级 Web 应用框架，广泛用于构建高效、可扩展的服务器端应用。以下是快速入门指南：

1. Installation

首先，确保已安装 Node.js 和 npm。通过终端运行以下命令创建项目：

mkdir express-project  
cd express-project  
npm init -y  
npm install express  

📌 Tip: 如果你对 Node.js 基础不熟悉，可先阅读 Node.js 入门教程。

2. Basic Setup

创建 app.js 文件并添加以下代码：

const express = require('express');  
const app = express();  
const port = 3000;  

app.get('/', (req, res) => {  
  res.send('Hello World!');  
});  

app.listen(port, () => {  
  console.log(`Server running at http://localhost:${port}`);  
});  

运行 node app.js 后，访问 http://localhost:3000 即可看到结果。

3. Routing & Middleware

• Routing: 使用 app.get(), app.post() 等方法定义路由。

  app.get('/about', (req, res) => {  
    res.send('About Page');  
  });  
  

• Middleware: 添加中间件处理请求（如日志、验证）。

  app.use((req, res, next) => {  
    console.log('Middleware executed!');  
    next();  
  });  
  

🔗 想深入了解路由机制？查看 Express 路由详解。

4. Templating with EJS

安装 EJS 模板引擎：

npm install ejs  

在 app.js 中设置视图引擎：

app.set('view engine', 'ejs');  

渲染页面示例：

app.get('/template', (req, res) => {  
  res.render('index', { title: 'EJS Example' });  
});  

5. Common Issues

• ❌ 404 Error: 使用自定义 404 页面：

  app.use((req, res) => {  
    res.status(404).send('Page Not Found');  
  });  
  

• ⚠️ CORS Problem: 安装 cors 中间件解决跨域问题：

  npm install cors  
  

  const cors = require('cors');  
  app.use(cors());  
  

扩展学习：Express 中间件指南 👉