Python调用C++共享库报错：ctypes.CDLL指定模块未找到

这种PyCharm和命令行环境不一致的坑我之前踩过好几次，大概率是环境配置或者工作目录的问题，给你几个实用的排查和解决方向：

1. 对齐PyCharm和命令行的Python环境 #

命令行里能正常运行，说明你的系统Python环境没问题，但PyCharm可能默认用了虚拟环境或者另一个Python版本。先确认两者的Python路径是否一致：

• 在命令行执行：

  python3 -c "import sys; print(sys.executable)"
  

• 复制输出的路径，打开PyCharm的File > Settings > Project: [你的项目名] > Python Interpreter，点击齿轮图标选择Add，然后选Existing environment，把刚才复制的路径粘进去，设置为项目的解释器。

2. 确保共享库的依赖路径被正确识别 #

Linux下共享库的加载依赖LD_LIBRARY_PATH环境变量，PyCharm的运行环境可能没继承命令行的这个变量：

• 先在命令行用ldd library.so查看你的共享库依赖的其他系统库是否都能找到，如果有缺失的库，需要把对应路径加到环境变量里。
• 打开PyCharm的Run Configuration（右上角运行按钮旁边的下拉框，选Edit Configurations），在Environment variables里添加：

  LD_LIBRARY_PATH=/path/to/your/library/directory:$LD_LIBRARY_PATH
  

  把/path/to/your/library/directory换成你的.so文件所在的绝对路径。

3. 确认加载的路径绝对正确 #

有时候PyCharm的工作目录和你命令行的工作目录不一样，导致相对路径失效：

• 在Python代码里先打印出你要加载的库的绝对路径，验证是否正确：

  import os
  print(os.path.abspath("library.so"))
  

• 然后用绝对路径加载：

  from ctypes import CDLL
  lib = CDLL(os.path.abspath("library.so"))
  

4. 检查编译共享库的选项 #

虽然你命令行能运行，但还是确认下编译命令是否正确，避免潜在的兼容性问题：

• 编译C++共享库的标准命令应该是：

  g++ -fPIC -shared -o library.so your_source.cpp
  

  -fPIC确保生成位置无关代码，-shared指定生成共享库，缺了这两个参数可能在某些环境下出现加载问题。

关于Boost.Python的补充 #

如果觉得ctypes的手动类型转换和路径问题太麻烦，Boost.Python确实是更省心的选择——它能直接把C++的函数、类包装成Python可直接导入的模块，不用再折腾ctypes的加载逻辑。编译的时候需要链接Boost.Python库，比如针对Python3的编译命令大概是：

g++ -fPIC -shared -o my_module.so my_code.cpp -lboost_python3

生成的my_module.so可以直接在Python里import my_module调用，能避开很多环境路径相关的问题。

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