一、项目概述

DjangoBlog 是基于 Django 5.2.9 开发的轻量化开源个人博客系统，采用 Django 经典的 MVT 架构（Model-View-Template），实现了完整的博客功能生态，同时具备高度可扩展性和易用性。它既可以作为学习 Django 全栈开发的实战案例，也能直接部署为线上个人博客使用。

二、核心架构：MVT 模式详解

Django 的 MVT 架构将数据、业务逻辑和页面渲染彻底分离，让代码更易维护、扩展：

1. Model（模型层）—— 数据的定义与交互

核心职责：定义数据结构、映射数据库表，通过 Django ORM 实现数据库操作（无需写原生 SQL）。

• 在本项目中的体现：
  • 核心模型：Article（文章）、Category（分类）、Tag（标签）、Comment（评论）、User（用户）、Link（友情链接）等。
  • 数据关系：
    • 文章 ↔ 分类：多对一（一篇文章归属于一个分类，一个分类下有多篇文章）
    • 文章 ↔ 标签：多对多（一篇文章可关联多个标签，一个标签可关联多篇文章）
    • 文章 ↔ 评论：一对多（一篇文章下可有多条评论）
    • 用户 ↔ 文章 / 评论：一对多（用户可发布多篇文章、多条评论）
  • 示例：Article 模型定义了标题、正文、摘要、发布时间、浏览次数、作者等字段，通过 objects 管理器实现文章的增删改查。

2. View（视图层）—— 业务逻辑的处理中枢

核心职责：接收 HTTP 请求，执行业务逻辑，调用 Model 层获取 / 处理数据，将结果传递给 Template 层渲染页面。

• 在本项目中的体现：
  • 核心视图：
    • ArticleListView：处理首页请求，获取分页文章列表，按发布时间倒序展示。
    • ArticleDetailView：处理文章详情页请求，获取单篇文章数据、关联评论、计算阅读时间、统计浏览次数。
    • CategoryView：处理分类页请求，获取指定分类下的所有文章。
    • TagView：处理标签页请求，获取指定标签下的所有文章。
    • CommentView：处理用户提交评论的 POST 请求，验证数据并保存到数据库。
  • 业务逻辑：视图层封装了所有用户交互的核心逻辑，比如评论提交验证、阅读时间计算、浏览次数更新、搜索结果过滤等。

3. Template（模板层）—— 页面的渲染与展示

核心职责：使用 Django 模板语言（DTL）将视图传递的数据动态渲染为 HTML 页面，负责最终的用户界面展示。

• 在本项目中的体现：
  • 模板结构：
    • base.html：基础模板，包含导航栏、页脚、静态资源引入等公共部分，其他模板继承该模板。
    • index.html：首页模板，循环展示文章列表，包含标题、摘要、发布时间、阅读量等信息。
    • detail.html：文章详情模板，展示文章正文、作者信息、评论区、相关推荐等。
    • sidebar.html：侧边栏模板，展示分类目录、标签云、最新评论、文章排行等。
    • admin/：后台管理模板，基于 Django 原生 admin 扩展，方便管理内容。
  • 动态渲染：通过 DTL 语法（如 {% for %} 循环、{{ variable }} 变量输出、{% if %} 条件判断）将视图传递的数据填充到 HTML 中，实现页面的动态生成。

三、核心功能模块

1. 内容管理：支持文章的增删改查、分类管理、标签管理、独立页面管理（如「关于我」）。
2. 评论系统：支持匿名 / 登录用户评论，包含评论审核、回复功能。
3. 全文搜索：集成 django-haystack + Elasticsearch，实现文章标题 / 正文的高效检索。
4. 插件扩展：内置可插拔插件系统，开箱即用的插件包括：
   • 黑夜模式（dark_mode）
   • 文章版权声明（article_copyright）
   • 阅读时间预测（reading_time）
   • 文章浏览次数统计（view_count）
   • SEO 优化器（seo_optimizer）
   • 图片懒加载（image_lazy_loading）
   • 文章推荐（article_recommendation）
5. 静态资源优化：使用 django-compressor 压缩 CSS/JS 文件，提升页面加载速度。
6. 响应式设计：基于 Bootstrap 实现，完美适配 PC 端和移动端。
7. 后台管理：Django 原生 admin 后台，可视化管理所有数据，无需额外开发管理界面。
8. 测试数据生成：提供 create_testdata 命令，一键生成测试文章、分类、评论等数据，方便开发调试。

四、技术亮点

• 清晰的 MVT 分层：数据、逻辑、视图彻底解耦，代码可维护性极强，是学习 Django 全栈开发的绝佳案例。
• 插件化架构：功能模块高度独立，可灵活开启 / 关闭插件，也能快速自定义开发新插件。
• ORM 数据库操作：无需编写原生 SQL，降低数据库操作复杂度，同时支持 SQLite/MySQL 多种数据库。
• 模板继承机制：公共页面部分复用，减少代码冗余，提升开发效率。
• 缓存支持：可选集成 Redis 缓存，优化页面访问速度，适合高并发场景。
• 完整的开发工具链：内置测试数据生成、静态资源压缩等工具，简化开发调试流程。

五、部署方式

项目支持多种部署方案，可根据需求选择：

1. 开发环境：直接使用 python manage.py runserver 启动，适合本地调试。
2. 传统部署：Nginx + uWSGI/Gunicorn，适合线上服务器部署。
3. Docker 部署：内置 Dockerfile，容器化快速部署，彻底解决环境配置问题。
4. Kubernetes 部署：提供 K8s 部署配置，适合云原生环境。

六、图片展示