如何实现Python3.10中import foo自动导入foobar，兼容多版本环境？

有两种可行方案，均无需修改现有代码的导入语句，也不用改动site-packages里的foobar模块：

方法一：全局模块映射（推荐） #

在Python3.10虚拟环境的lib/python3.10/site-packages目录下创建（或修改）sitecustomize.py文件，写入以下代码：

import sys
# 先加载真实的foobar模块
import foobar
# 将模块名'foo'指向已加载的foobar实例
sys.modules['foo'] = foobar

Python启动时会自动执行sitecustomize.py，之后任何地方执行import foo都会直接获取foobar模块，同时其他依赖依然可以正常import foobar，两者完全互不干扰。

方法二：自定义垫片包 #

1. 在任意能被Python识别的路径下（比如common/src同级目录）创建foo目录，内部新建__init__.py：

import sys
import foobar
# 替换当前foo模块为foobar
sys.modules['foo'] = foobar

2. 将这个foo目录所在路径添加到Python的PYTHONPATH环境变量中（可在虚拟环境激活脚本bin/activate末尾追加：export PYTHONPATH="/path/to/foo/dir:$PYTHONPATH"）。

这样common/src里的代码执行import foo时，会优先加载这个垫片包，自动映射到foobar，同时不影响其他依赖对foobar的正常导入。

两种方案的核心逻辑一致：利用Python的模块加载机制，sys.modules是存储已加载模块的全局字典，提前将'foo'键指向foobar模块后，后续import foo会直接从字典中取出已有模块，不会再去搜索新的foo包。

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