VSCode无法识别Robot Framework的ConfluentKafkaLibrary求助

问题核心 #

报错的本质并非ConfluentKafkaLibrary未安装，而是你的Python环境缺少底层系统依赖的_bz2模块——该模块是confluent-kafka依赖的第三方库运行必需的组件。

分系统解决方案 #

Linux（Ubuntu/Debian 系列） #

• 先安装bz2的系统开发包：

  sudo apt-get update && sudo apt-get install libbz2-dev -y
  

• 若你的Python是源码编译安装的，需重新编译Python以关联该依赖：

  # 替换为你的Python源码实际路径
  cd /path/to/Python-3.x.x
  ./configure --enable-optimizations
  make && sudo make install
  

macOS #

• 通过Homebrew安装bz2依赖：

  brew install bzip2
  

• 源码编译Python的情况，需指定bz2路径后重新编译：

  cd /path/to/Python-3.x.x
  ./configure --enable-optimizations --with-bz2=$(brew --prefix bzip2)
  make && sudo make install
  

Windows #

• 官方Python安装包用户：重新下载对应版本的官方安装程序，选择「自定义安装」并确保勾选「Add Python to PATH」，执行覆盖安装（默认已包含_bz2模块）。
• Conda环境用户：直接执行以下命令补全依赖：

  conda install bzip2 -y
  

验证与收尾 #

1. 重装相关Python库：

   pip uninstall -y robotframework-confluentkafkalibrary confluent-kafka
   pip install robotframework-confluentkafkalibrary
   

2. 在Python交互终端测试导入：

   import _bz2
   from ConfluentKafkaLibrary import ConfluentKafkaLibrary
   

   无报错则说明依赖修复完成。
3. 在VSCode中执行「Robot Framework: Clear caches and restart」操作，重新加载库定义。

内容的提问来源于stack exchange，提问作者Alexandre de Paula Sousa