无Python包安装权限时如何正确使用拷贝的第三方库源文件

报错原因 #

• 路径添加逻辑错误：你调用os.path.dirname('ext_lib_folder/')得到的结果是空字符串，将空字符串加入sys.path等效于仅添加当前工作目录，Python无法检索到存放在ext_lib_folder下的库文件。
• 库目录结构不符合导入要求：要么你拷贝时遗漏了库自带的__init__.py包标识文件，要么你把库的内部文件直接放在了ext_lib_folder下、没有保留原库的包文件夹结构，导致Python无法识别这是一个可导入的包。
• 跨环境兼容问题：如果该库包含C/C++编译生成的二进制扩展文件（.so/.pyd/.dll格式），不同设备、不同系统编译的扩展文件不兼容，也会触发导入失败。

正确操作步骤 #

1. 先确认拷贝结构：在有权限的设备上找到安装好的external_lib包文件夹（一般在Python安装目录的site-packages下，是一个名称为external_lib、包含__init__.py的文件夹），将整个external_lib文件夹直接拷贝到无权限设备的ext_lib_folder目录下，确保最终目录结构如下：

你的项目根目录
├── 你的运行脚本.py
└── ext_lib_folder
    └── external_lib
        ├── __init__.py
        ├── 其他库文件...

2. 替换原有的路径添加代码，直接将ext_lib_folder的绝对路径加入sys.path，避免相对路径受工作目录影响：

import sys
import os

# 获取当前脚本所在目录的绝对路径，拼接ext_lib_folder的绝对路径
ext_lib_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "ext_lib_folder")
sys.path.insert(0, ext_lib_path)

# 正常导入即可
import external_lib

3. 如果库包含二进制扩展，不要拷贝编译后的版本，改为拷贝库的源代码包（带setup.py/pyproject.toml的源码目录）到ext_lib_folder下，在当前设备执行python setup.py build_ext --inplace进行本地编译后再导入。

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