初始化项目环境

完成迁移、超级用户、App 创建，让项目具备可运行的基础。

1. 数据库迁移

python manage.py makemigrations   # 生成迁移文件
python manage.py migrate          # 同步到数据库

迁移机制的两个角色：

• makemigrations — 比较 Model 与上次状态，生成增量迁移文件
• migrate — 把迁移文件应用到数据库

已执行过的迁移会记录在 django_migrations 表中，不会重复执行。

2. 超级用户

python manage.py createsuperuser --username admin --email admin@example.com

后台地址：http://127.0.0.1:8000/admin/

3. 创建 App

python manage.py startapp post

生成：

post/
├── __init__.py
├── admin.py        # Admin 注册
├── apps.py         # App 配置
├── migrations/     # 迁移文件目录
├── models.py       # 数据模型
├── tests.py        # 测试
└── views.py        # 视图

注册到 INSTALLED_APPS：

INSTALLED_APPS = [
    ...
    "post.apps.PostConfig",
]

2026 推荐：把业务 App 统一放到 apps/ 包下，例如 apps.post。

4. 依赖文件

requirements.txt：

Django>=5.1,<5.2
mysqlclient>=2.2
python-decouple>=3.8

或更现代的 pyproject.toml：

[project]
name = "my-bbs"
version = "0.1.0"
requires-python = ">=3.12"
dependencies = [
    "django>=5.1,<5.2",
    "mysqlclient>=2.2",
]

5. IDE 装载

VSCode（推荐）：

1. 打开项目根目录
2. 安装扩展：Python、Pylance、Django
3. 选择 Python 解释器为 .venv/bin/python

PyCharm：

1. File → Open 选择项目根目录
2. Settings → Project → Python Interpreter 选择虚拟环境
3. 启用 Django 支持：Languages & Frameworks → Django

6. 健康检查

python manage.py check          # 配置 + Model 校验
python manage.py showmigrations # 迁移状态