Debian11安装运行Quart遇ImportError及TypeError问题求助

错误1：无法从markupsafe导入'soft_unicode' #

这个问题源于MarkupSafe 2.0+移除了soft_unicodeAPI，而Quart 0.18.3与高版本MarkupSafe、Jinja2存在兼容冲突，通过锁定兼容版本即可解决：

• 卸载现有冲突版本：

  pip uninstall -y Jinja2 MarkupSafe
  

• 安装Quart兼容的指定版本：

  pip install Jinja2==3.0.3 MarkupSafe==2.0.1
  

错误2：entry_points()收到意外关键字参数'group' #

该报错是Debian 11自带的setuptools版本过低导致的（系统默认版本不支持group参数），升级setuptools即可修复：

pip install --upgrade setuptools

完整操作流程 #

1. 先升级setuptools，避免后续安装出现参数错误：

   pip install --upgrade setuptools
   

2. 重新安装匹配版本的依赖包：

   pip uninstall -y Jinja2 MarkupSafe
   pip install Jinja2==3.0.3 MarkupSafe==2.0.1
   

3. 验证Quart是否正常初始化：

   python -c "from quart import Quart; app = Quart(__name__); print('Quart initialized successfully')"
   

额外建议 #

如果仍出现依赖冲突，建议使用虚拟环境隔离全局Python包：

python -m venv quart_env
source quart_env/bin/activate
pip install quart==0.18.3

虚拟环境中安装的Quart会自动拉取兼容的依赖版本，能有效避免系统级包冲突。

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