方法一:使用社区提供的脚手架工具 —— koa-generator(不推荐)
koa-generator没人维护,已经过时
方法二、手动搭建一个标准的 Koa 项目(推荐)
1. 初始化项目
bash
深色版本
mkdir my-koa-app
cd my-koa-app
npm init -y
2. 安装 Koa
bash
深色版本
npm install koa
3. 创建基础目录结构
bash
深色版本
my-koa-app/
├── app.js # 主程序入口
├── config/ # 配置文件
├── controllers/ # 控制器逻辑
├── routes/ # 路由定义
├── middleware/ # 自定义中间件
├── models/ # 数据模型
├── utils/ # 工具函数
├── public/ # 静态资源(可选)
└── package.json
4. 编写入口文件 app.js
js
深色版本
const Koa = require('koa');
const app = new Koa();
app.use(async (ctx) => {
ctx.body = 'Hello, Koa!';
});
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
console.log(`Server running on http://localhost:${PORT}`);
});
5. 启动项目
bash
深色版本
node app.js
访问 http://localhost:3000,你应该能看到页面输出 "Hello, Koa!"
方法三:使用模板项目(GitHub 模板)
你也可以 fork 或 clone 一些现成的 Koa 项目模板,比如:
✅ 推荐搭配的常用中间件
| 功能 | 中间件 |
|---|---|
| 路由 | koa-router |
| 请求体解析 | koa-bodyparser |
| 静态资源服务 | koa-static |
| 错误处理 | koa-onerror |
| 日志 | koa-logger |
| JWT 认证 | koa-jwt |
| MongoDB 连接 | mongoose |