Django 安装与配置

当前推荐：Django 5.1 LTS（支持到 2028 年 12 月）。

版本选择

Django	Python	状态
4.2 LTS	3.8–3.12	维护中
5.0	3.10–3.13	已停止
5.1 LTS	3.10–3.13	推荐
5.2	3.11–3.14	即将发布

LTS = 长期支持（Long Term Support），保证安全更新至少 3 年。

安装

# 最新 LTS
uv pip install "django>=5.1,<5.2"

# 指定版本
uv pip install django==5.1.4

# 验证
python -m django --version

项目目录结构（2026 推荐）

my_bbs/
├── .venv/                  # 虚拟环境（gitignore）
├── pyproject.toml          # 依赖与项目元数据
├── manage.py
├── config/                 # 项目配置包
│   ├── settings/
│   │   ├── base.py
│   │   ├── dev.py
│   │   └── prod.py
│   ├── urls.py
│   └── wsgi.py
├── apps/                   # 业务 App 集合
│   └── post/
└── requirements/           # 锁文件（可选）
    ├── base.txt
    ├── dev.txt
    └── prod.txt

启动开发服务器

python manage.py runserver
python manage.py runserver 8080       # 指定端口
python manage.py runserver 0.0.0.0:8000  # 局域网访问

最佳实践

• ✅ 用 pyproject.toml + uv 管理依赖
• ✅ 区分 dev / prod 配置
• ✅ SECRET_KEY 通过环境变量注入
• ❌ 生产环境不要 runserver