这是Linux/macOS下动态链接库缺失错误，Python导入C扩展模块时因系统找不到其依赖的.so共享库（如libcuda.so.1）而失败，根源在于动态链接器搜索路径未包含该库。

ImportError: libxxx.so: cannot open shared object file 是什么问题 这是 Linux/macOS 下典型的动态链接库缺失错误，Python 在 import 某个 C 扩展模块（比如 numpy、torch、cv2）时，底层调用的 .so 文件找不到。不是 Python 模块没装，而是它依赖的系统级共享库（如 libglib-2.0.so.0、libcuda.so.1）压根不在系统的动态链接器搜索路径里。

常见现象包括：

• 同一段代码在一台机器能跑，在另一台报 ImportError: libxxx.so: cannot open shared object file
• pip install 成功，但 import xxx 直接失败
• 用 ldd /path/to/_module.cpython-*.so 显示某行是 not found

怎么快速定位缺哪个 .so 文件 先确认出错模块的底层 .so 路径，再用 ldd 查依赖树：

以 cv2 为例：

python -c "import cv2; print(cv2.__file__)"

输出类似 /usr/local/lib/python3.9/site-packages/cv2/cv2.cpython-39-x86_64-linux-gnu.so，然后运行：

361SCAN security check your skill python scripts

扫描并分析已安装技能，用于查看指定技能目录的名称、描述和详情，或列出所有已安装的技能。

下载

ldd /usr/local/lib/python3.9/site-packages/cv2/cv2.cpython-39-x86_64-linux-gnu.so | grep "not found"

关键点：

立即学习“Python免费学习笔记（深入）”；

• 必须用 ldd 查模块本身的 .so，不是查 python 可执行文件
• 如果提示 not a dynamic executable，说明该模块是纯 Python 或用了 PyO3/PyBind11 但打包时静态链接了——这时问题可能出在运行时环境变量或 ABI 兼容性上
• 某些 .so 名字带版本号（如 libgfortran.so.5），但系统只装了 libgfortran.so.6，版本不匹配也会显示 not found

LD_LIBRARY_PATH 不起作用？检查这三件事 设了 LD_LIBRARY_PATH 还报错，大概率是以下某个环节断了：

• Python 进程启动前没生效：在 shell 中 export 后，要重新开终端或用 source ~/.bashrc；用 IDE（如 PyCharm）要重启，且需确认 IDE 启动方式是否继承 shell 环境变量
• 被 setuptools 或 auditwheel 重写 rpath：某些 wheel 包在打包时硬编码了 RPATH，会覆盖 LD_LIBRARY_PATH；可用 readelf -d /path/to/module.so | grep RPATH 查看
• 系统开启了安全限制：CentOS/RHEL 的 secure_getenv 机制会让 setuid 程序忽略 LD_LIBRARY_PATH；若用 sudo python，该变量默认被丢弃

修复方案优先级：从临时到长期

按实际场景选最稳妥的方式：

• 临时调试：用 LD_PRELOAD=/path/to/libxxx.so python -c "import xxx" 强制预加载（仅限单个库、不解决依赖链）
• 用户级修复：把库路径加进 $HOME/.bashrc，然后 echo '/path/to/libs' | sudo tee /etc/ld.so.conf.d/my-python.conf && sudo ldconfig
• 容器内：Dockerfile 中用 RUN echo "/usr/local/lib" > /etc/ld.so.conf.d/local.conf && ldconfig，比反复设 LD_LIBRARY_PATH 更可靠
• 避免重装：不要因为缺 libglib 就 pip uninstall/reinstall torch——那是治标不治本，真正要装的是系统包，比如 apt install libglib2.0-0

真正容易被忽略的是：很多 Python 包的 wheel 发布时已内置部分依赖（如 manylinux 轮子带 libgfortran），但如果你用 --no-binary 或源码编译，这些就全靠系统提供——此时缺失的库类型和数量会陡增。