Ubuntu环境下Django项目执行命令报错：PY_SSIZE_T_CLEAN宏未定义

这个错误的核心原因是Python版本与mysqlclient库版本不兼容：Python 3.10及以上版本要求C扩展库必须定义PY_SSIZE_T_CLEAN宏才能使用#格式的参数，而你使用的mysqlclient==1.4.2.post1是较旧的版本，未适配这一要求。结合你的Django版本（2.2.1），可以通过以下两种方案解决：

方案一：升级mysqlclient到兼容版本 #

Django 2.2.x支持mysqlclient>=1.3.13，而mysqlclient>=2.0.0已适配Python 3.10+的宏定义要求，操作步骤如下：

• 编辑你的requirements.txt，将mysqlclient==1.4.2.post1替换为：

  mysqlclient>=2.0.0
  

• 重新安装依赖（确保已激活项目虚拟环境）：

  pip install -r requirements.txt --upgrade
  

方案二：降级Python到Django 2.2.x支持的版本 #

Django 2.2.x官方支持的Python版本为3.5、3.6、3.7、3.8，如果你不想升级依赖，可以：

• 使用系统包管理器或pyenv安装Python 3.8
• 创建基于Python 3.8的虚拟环境：

  python3.8 -m venv venv
  source venv/bin/activate
  

• 重新安装所有依赖：

  pip install -r requirements.txt
  

验证修复 #

完成上述操作后，执行以下命令验证问题是否解决：

python manage.py runserver

内容的提问来源于stack exchange，提问作者kshitij