一、项目简介

DjangoBlog 是基于 Django5.2.9 开发的全功能开源博客，MVT 架构，支持响应式布局、Markdown 编辑器、第三方登录、SEO 优化、Redis 缓存、全文检索，非常适合 Django 进阶学习与直接上线使用。

核心技术栈

- 后端：Django5.2.9

- 数据库：MySQL / SQLite3

- 搜索：Haystack + Whoosh/ES

- 前端：Bootstrap + jQuery

- 编辑器：django-mdeditor - 缓存：Redis - 登录：OAuth2（GitHub、微博等） 

二、环境准备（必做）

1. 安装 Python3.9+ 2. 安装 Git 3. 推荐使用虚拟环境隔离依赖

 # 创建虚拟环境 
python -m venv venv 
# 激活（Windows） 
venv\Scripts\activate
 # 激活（Mac/Linux） 
source venv/bin/activate

三、一键部署

5 步跑起博客

1. 克隆项目

git clone https://github.com/liangliangyy/DjangoBlog.git cd DjangoBlog 

2. 安装依赖 

pip install -r requirements.txt

3. 数据库迁移 
 

# 生成迁移文件 python manage.py makemigrations

# 执行迁移 python manage.py migrate

4. 生成测试数据 + 创建超级用户
 

# 生成测试文章、分类、标签

python manage.py create_testdata

# 创建管理员（后台登录用）

python manage.py createsuperuser 

5. 启动项目 

python manage.py runserver

 看到如下提示即成功：

Starting development server at http://127.0.0.1:8000/

四、访问验证

- 博客首页：http://127.0.0.1:8000

- 管理后台：http://127.0.0.1:8000/admin

- 测试数据已自动生成，可直接查看文章列表、分类、标签、分页、搜索等功能。

五、项目核心亮点

1. 响应式布局：PC/手机自适应

2. SEO 友好：自动生成 Sitemap、支持搜索引擎推送

3. 插件化：一键开关暗黑模式、版权、阅读时长

4. 社交登录：GitHub、微博一键登录

5. Markdown 编辑器：支持代码高亮、图片上传

6. 全文检索：快速搜索文章内容

7. Redis 缓存：提升访问速度

六、常见问题与解决方案

1. MySQL 连接失败 - 安装 mysqlclient

pip install mysqlclient

- 在 settings.py 配置数据库 

python DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'djangoblog', 'USER': 'root', 'PASSWORD': '你的密码', 'HOST': '127.0.0.1', 'PORT': '3306', } } 

2. 静态文件加载异常 

python manage.py collectstatic 

3. 依赖安装报错 - 升级 pip

python -m pip install --upgrade pip 

- 重新安装 

pip install -r requirements.txt --force-reinstall 

4. 端口被占用 
 

# 指定端口启动

python manage.py runserver 0.0.0.0:8080 

七、总结

DjangoBlog 是 Django5.x 时代最适合练手+上线的博客项目之一，代码优雅、功能完整、文档完善。跟着本文 5 分钟即可跑通，非常适合用来学习 Django 模型设计、视图优化、插件开发、缓存与搜索等进阶技能。