如何将模块添加到Python全局可导入库列表（无Pip安装权限场景）

方案1：修改模块搜索路径（最简便） #

直接在main.py的最开头加入以下代码，将项目根目录加入Python的模块搜索列表，所有第三方包都可以直接通过原有绝对导入语句访问，不需要修改任何第三方包的内部代码：

import sys
from pathlib import Path
# 将当前main.py所在的根目录加入模块搜索路径的最高优先级
sys.path.insert(0, str(Path(__file__).parent.resolve()))

Python导入模块时会按顺序从sys.path记录的路径中搜索对应包，将存了foo、bar的项目根目录加到搜索路径最前面后，所有第三方代码里的import foo、import bar语句都会直接命中你本地的包，不会出现导入失败的问题。

方案2：模块别名映射（适用于自定义包存放路径的场景） #

如果你把所有第三方依赖都统一放在非根目录的文件夹下（比如专门存依赖的vendor文件夹），可以用sys.modules提前注册模块映射，所有后续导入都会直接指向你指定的路径：

import sys
from pathlib import Path
# 定义依赖包存放的路径
VENDOR_PATH = Path(__file__).parent / "vendor"
sys.path.insert(0, str(VENDOR_PATH))
# 提前导入依赖并注册到系统模块缓存
import foo
import bar
sys.modules["foo"] = foo
sys.modules["bar"] = bar

Python导入模块时会优先查询sys.modules里已经缓存的模块实例，提前注册后就算后续其他模块导入这两个包，也会直接使用你提前导入的本地模块，完全兼容第三方代码的原有导入写法。

验证方法 #

在main.py开头加入路径修改代码后，可以加入以下代码验证导入是否正常：

import foo
import bar
from my_module import somefile
print("所有模块导入正常")

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