如何将多独立虚拟环境的Python项目合并为全局项目并解决导入问题

核心思路 #

先统一所有项目的虚拟环境，再调整项目结构让Python能识别跨项目的模块，从根源解决ModuleNotFoundError。

步骤1：创建全局统一虚拟环境 #

• 在根目录（Python文件夹）下执行命令，创建全局虚拟环境：

  python -m venv global_venv
  

• 导出每个子项目的依赖：进入子项目的venv并激活，执行pip freeze > [项目名]_requirements.txt（比如Send_Mails项目就导出为send_mails_requirements.txt）
• 激活全局虚拟环境，依次安装所有子项目的依赖：

  pip install -r send_mails_requirements.txt
  pip install -r create_files_requirements.txt
  pip install -r scrape_web_requirements.txt
  

• 删除各个子项目原有的venv文件夹，后续所有开发都使用这个全局虚拟环境。

步骤2：调整项目结构为可导入的包格式 #

给每个子项目文件夹添加一个空的__init__.py文件，让Python将其识别为可导入的包，调整后的结构如下：

Python
|
|-- global_venv
|
|-- Send_Mails
|   |- __init__.py
|   |- main.py
|
|-- Create_Files
|   |- __init__.py
|   |- main.py
|
|-- Scrape_Web
|   |- __init__.py
|   |- main.py

可选优化：把main.py里的核心功能拆分到单独的模块文件（比如Send_Mails里新建send_mails_core.py），只留入口逻辑在main.py，这样导入时更清晰。

步骤3：解决跨项目导入问题 #

有两种可行方法，任选其一即可：

方法一：在代码中添加根目录到Python路径

在需要跨项目导入的文件（比如Create_Files/main.py）开头加入以下代码：

import sys
from pathlib import Path

# 获取项目根目录的绝对路径
root_path = Path(__file__).parent.parent.resolve()
# 将根目录加入Python搜索路径
sys.path.append(str(root_path))

之后就能正常导入其他项目的模块：

# 导入Send_Mails/main.py中的目标函数或类
from Send_Mails.main import send_email_function

方法二：设置PYTHONPATH环境变量

激活全局虚拟环境后，在Python根目录下执行对应系统的命令，将根目录设为Python的全局搜索路径：

• Windows系统：

  set PYTHONPATH=%cd%
  

• Linux/macOS系统：

  export PYTHONPATH=$(pwd)
  

设置完成后，无需修改代码，直接在任意子项目中导入其他项目的模块即可。

额外建议 #

• 全局环境配置完成后，在根目录执行pip freeze > requirements.txt，导出所有依赖，方便后续快速重建环境。
• 如果不同子项目存在依赖版本冲突，需要先协调版本，确保所有功能在全局环境下能正常运行。

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