Python 3.12可运行Django 3.2.22+、4.0+及5.0+，但不支持Django 3.1及更早版本；升级需分步进行，注意第三方包、时区配置及数据库驱动兼容性。
Python 3.12 可以运行老版 Django 项目，但不是所有旧版本都支持 —— 关键看 Django 版本是否在官方兼容列表里。Django 3.2 LTS 是最后一个支持 Python 3.12 的老版本（需 ≥3.2.22），而 Django 4.0+ 全系原生支持 Python 3.12。
检查当前 Django 是否支持 Python 3.12
直接查 pip show django 输出的版本号，再对照官方兼容表：
- Django 3.2.22+ ✅ 支持 Python 3.12（LTS，最后支持到 2024年4月）
- Django 4.0–4.2 ✅ 全支持 Python 3.12
- Django 5.0+ ✅ 原生支持（要求 Python 3.10+）
- Django 3.1 或更早 ❌ 不支持 Python 3.12（会报
ImportError: cannot import name 'Mapping' from 'collections'等错误）
升级 Django 到兼容版本的实操要点
若当前是 Django 3.1 或 2.x，不能跳过中间版本直接装 5.0 —— 迁移必须分步来，否则 manage.py migrate 会失败或数据错乱：
- 先升到 Django 3.2.22（最后一个兼容旧模型语法的 LTS）：
pip install django==3.2.22 - 跑一次
python manage.py check --deploy，重点看是否有弃用警告（如django.core.context_processors已移除） - 再升到 Django 4.2.16（推荐生产环境长期支持版）：
pip install django==4.2.16 - 注意：Django 4.0 起默认启用
USE_TZ = True，若老项目没配时区，datetime字段读写可能出偏移
Python 3.12 自身引发的兼容问题
即使 Django 版本 OK，Python 3.12 的改动也可能让老代码崩：
立即学习“Python免费学习笔记（深入）”；
-
collections.Mapping和collections.Iterable已彻底移除 → 老项目里手动 import 这些的代码要改成collections.abc.Mapping - 某些第三方包（如
django-notifications≤ 1.9）未适配 Python 3.12 → 查pip show django-notifications，低于 2.0 的必须升到django-notifications>=2.0.0 -
inspect.getargspec()已弃用 → 若自定义 middleware 或管理命令用了这个，换成inspect.signature() - 虚拟环境创建方式不变，但建议用
python3.12 -m venv venv显式指定解释器，避免系统默认 Python 混淆
最常被忽略的是数据库驱动 —— Python 3.12 编译的 C 扩展不兼容旧版 psycopg2 或 mysqlclient。比如 psycopg2==2.8.6 会 import 失败，必须升到 psycopg2>=2.9.7；MySQL 用户则要确认 mysqlclient>=2.1.0。
