如何从完整路径导入含环境依赖的自定义Python模块？

方案1：直接从文件路径导入模块（不污染sys.path） #

这种方法不会修改全局的sys.path，避免干扰依赖库的搜索顺序，直接加载指定路径的模块：

import importlib.util
import os

# 替换成你的模块文件的完整路径
module_path = os.path.abspath("path_to_my_module/my_module.py")
spec = importlib.util.spec_from_file_location("my_module", module_path)
my_module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(my_module)

导入后即可正常使用my_module内的功能，依赖库会从当前Python环境的标准路径加载。

方案2：调整sys.path的加载顺序（避免依赖搜索冲突） #

如果坚持用sys.path的方式，先检查自定义模块路径下是否存在和依赖库同名的文件/文件夹（比如误放的numpy目录），存在则直接删除。同时确保当前环境的库搜索优先级高于自定义模块路径：

import sys
import os
# 先打印当前路径，排查是否有异常路径排在前面
print(sys.path)
# 将模块路径加到搜索列表末尾，确保优先搜索环境内的库
sys.path.append(os.path.abspath("path_to_my_module"))
import my_module

方案3：修复Windows DLL搜索路径 #

Windows系统下出现该错误，大概率是依赖库的DLL不在系统搜索路径中。需将当前Python环境中依赖库的DLL目录加到PATH环境变量：

import os
import sys
# 替换为你的环境DLL目录，比如conda环境的Library/bin，或site-packages对应库的DLL路径
dll_path = r"C:\Users\YourName\miniconda3\envs\your_env\Library\bin"
# 加到PATH最前面，确保优先搜索
os.environ['PATH'] = dll_path + os.pathsep + os.environ['PATH']

# 再导入自定义模块
sys.path.append(os.path.abspath("path_to_my_module"))
import my_module

方案4：规范包结构使用相对导入 #

将自定义模块整理成标准包结构：

my_project/
├── main.py
└── my_package/
    ├── __init__.py
    └── my_module.py

在main.py中通过包结构导入：

import sys
import os
sys.path.append(os.path.abspath("my_project"))
from my_package import my_module

这种结构能让依赖库的搜索逻辑更规范，减少冲突概率。

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