Rust Rocket Web 应用项目结构详解（MVC 风格）

✅ 项目总览：Rust Rocket Web 应用结构（MVC 风格）

rocket-web-app/ ├── Cargo.toml# Rust 项目配置文件├── Rocket.toml# Rocket 框架配置文件├── src/ │ ├── main.rs# 应用入口文件│ ├── lib.rs# 模块聚合文件│ ├── models/# 数据模型层（目录）│ ├── services/# 业务逻辑层（目录）│ ├── controllers/# 请求处理层（目录）│ ├── views/# 视图上下文（目录）（可选）│ ├── db/# 数据库连接管理（目录）│ ├── utils/# 工具模块（目录）（错误处理等）│ └── config/# 配置管理（目录）├── templates/# HTML 模板（目录）（Tera 引擎）├── static/# 静态资源（目录）（CSS/JS/图片）└── migrations/# 数据库迁移脚本（目录）

1. 项目结构设计思想

🎯 核心目标

• 可维护性：模块职责清晰，修改不影响全局
• 可扩展性：新增功能不破坏已有结构
• 可测试性：业务逻辑可独立测试
• 可部署性：配置清晰，支持多环境

2. 各目录详细解释

3. 模板目录结构（templates）

templates/ ├── base.html.tera# 公共布局（导航栏、页脚）├── index.html.tera# 首页├── users/ │ ├── list.html.tera# 用户列表页│ ├── detail.html.tera# 用户详情页│ └── create.html.tera# 创建用户表单页└── posts/ ├── list.html.tera# 帖子列表页├── detail.html.tera# 帖子详情页└── create.html.tera# 创建帖子表单页

✅ 模板按“功能模块”分子目录，避免根目录臃肿，便于前端协作。

4. 静态资源目录（static）

static/ ├── css/ │ └── style.css# 全局样式└── js/ └── main.js# 全局脚本

✅ 静态资源路径在 Rocket.toml 中配置，Rocket 会自动映射为 /static/css/style.css 这类 URL。

5. 数据库迁移目录（migrations）

migrations/ └── 001_initial_schema.sql# 初始建表语句

✅ 使用纯 SQL 文件，方便 DBA 审查；也可接入 sqlx migrate 工具做版本管理。

6. 配置文件（Rocket.toml）

✅ 支持环境变量覆盖，例如 ROCKET_PORT=8080 cargo run

7. 模块依赖关系图（单向依赖）

main.rs ├─ config ← 读取配置 ├─ db ← 创建连接池 ├─ services ← 依赖 db + models ├─ controllers ← 依赖 services + models └─ templates ← 由 controllers 渲染

✅ 禁止反向依赖：

• controllers 不能直接调用 sqlx
• services 不能依赖 rocket 相关类型
• models 保持纯数据结构，不依赖任何框架

8. 新增功能时的“标准操作流程”

假设要新增 “评论系统”：
1、models/ 新增 comment.rs 定义结构
2、migrations/ 新增 002_add_comment_table.sql
3、services/ 新增 comment_service.rs 实现业务
4、controllers/ 新增 comment_controller.rs 注册路由
5、templates/comments/ 新建模板文件
6、controllers/mod.rs 把新路由合并到总路由表

✅ 每一步只动一个模块，不碰其他目录，多人协作不冲突。

9. 部署相关文件（可扩展）

├── Dockerfile# 容器镜像构建├── docker-compose.yml# 本地一站式启动（Web+DB）├── .env.example# 环境变量模板├── README.md# 项目说明└── .github/ └── workflows/ └── ci.yml# GitHub Actions 自动测试

✅ 这些文件放在根目录，不污染 src，方便 DevOps 直接读取。

10. 一句话总结