BotCity框架ImportError求助：无法导入_priv_parser（循环依赖）

错误原因 #

该报错属于模块循环导入问题，通常由BotCity相关依赖版本不兼容、安装不完整，或Python/PyCharm的导入缓存未更新导致。

解决步骤 #

• 彻底重装BotCity依赖
  先卸载所有相关包，避免版本冲突：

  pip uninstall -y botcity botcity-documents botcity-framework-core
  

  手动删除Python site-packages目录下所有botcity相关文件夹，同时清理项目目录和依赖目录中的__pycache__文件夹。
  重新安装经过验证的稳定兼容版本：

  pip install botcity==0.2.7 botcity-documents==0.1.5
  

• 对齐PyCharm解释器与pip环境
  确认PyCharm使用的Python解释器和执行pip命令的环境一致：

  1. 打开File > Settings > Project: [你的项目名] > Python Interpreter
  2. 对比解释器路径与终端执行where python（Windows）/which python（Linux/macOS）的输出
  3. 若不一致，切换到正确的解释器，或直接在PyCharm内置终端中执行pip命令

• 修改导入方式
  放弃通配符导入，改为按需导入具体类，减少依赖链触发循环导入的概率：

  # 替换原有的 from botcity.document_processing import *
  from botcity.document_processing.parser import DocumentParser, Entry
  

• 刷新导入缓存
  在脚本开头添加以下代码强制刷新importlib缓存（仅作为临时调试手段）：

  import importlib
  importlib.invalidate_caches()
  

补充说明 #

仅升级botcity-documents无法解决问题，因为核心botcity包与文档处理模块版本不兼容时，会导致内部模块依赖逻辑混乱，触发循环导入。彻底重装并对齐版本是最直接的解决方式。

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