1. 环境准备

确保您的系统中已安装 Python 3.10+ 和 MySQL/MariaDB。

2. 克隆与安装

# 克隆项目到本地
git clone https://github.com/liangliangyy/DjangoBlog.git
cd DjangoBlog

# 安装依赖
pip install -r requirements.txt

3. 项目配置

• 数据库: 打开 djangoblog/settings.py 文件，找到 DATABASES 配置项，修改为您的 MySQL 连接信息。

  DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.mysql',
          'NAME': 'djangoblog',
          'USER': 'root',
          'PASSWORD': 'your_password',
          'HOST': '127.0.0.1',
          'PORT': 3306,
      }
  }
  

  

• 在 MySQL 中创建数据库:

  CREATE DATABASE `djangoblog` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  

• 更多配置: 关于邮件发送、OAuth 登录、缓存等更多高级配置，请参阅我们的 详细配置文档。

4. 初始化数据库

python manage.py makemigrations
python manage.py migrate

# 创建一个超级管理员账户
python manage.py createsuperuser

5. 运行项目

# (可选) 生成一些测试数据
python manage.py create_testdata

# (可选) 收集和压缩静态文件
python manage.py collectstatic --noinput
python manage.py compress --force

# 启动开发服务器
python manage.py runserver

现在，在您的浏览器中访问 http://127.0.0.1:8000/，您应该能看到 DjangoBlog 的首页了！

Django 博客项目全景介绍

本项目是一个基于 Django MVT 架构 构建的轻量级博客系统，专为快速开发与学习设计。项目成功运行于本地环境，采用 SQLite 作为默认数据库，无需配置复杂的 MySQL 服务即可实现完整的数据存取功能，极大降低了部署门槛。

核心架构解析 (MVT)：

1. Model (模型层)：位于 models.py，是项目的“数据仓库”。它定义了文章（Post）、用户（User）等数据的结构（如标题、正文、发布时间）。Django 通过它自动将 Python 类映射为数据库表，实现了代码与数据的无缝同步，开发者无需编写任何 SQL 语句。
2. View (视图层)：位于 views.py，是项目的“逻辑大脑”。它接收用户的 URL 请求，指挥 Model 层查询特定数据（如“获取最新5篇文章”），并将处理好的数据“注入”到指定的模板中。它决定了用户能看到什么内容，是连接数据与界面的核心枢纽。
3. Template (模板层)：由 .html 文件组成，是项目的“展示界面”。它利用 Django 模板语言（如 {{ variable }} 和 {% for %} 循环），将 View 传来的动态数据填充到静态 HTML 结构中，最终生成用户看到的精美网页。它只负责“长什么样”，完全不涉及业务逻辑。

此外，URL 配置 (urls.py) 充当路由分发器，精准地将不同网址导向对应的 View；Settings (settings.py) 则统管全局配置。整个项目结构清晰、耦合度低：修改数据库只需调整 Model，更换皮肤仅需编辑 Template，完美体现了高内聚、低耦合的工程思想，是理解现代 Web 开发的绝佳范例。