Python 3.11.6项目打包路径问题：模块导入失败求助

一、解决本地运行的导入错误问题 #

直接运行src_2/second.py时，Python默认将脚本所在的src_2目录加入sys.path，而非项目顶层的my_project，且顶层的__init__.py不会被执行，所以找不到src_1下的模块。可以用以下两种方法解决：

方法1：修改导入语句+以模块方式运行 #

• 在second.py中使用绝对导入：

  from src_1 import first
  

• 从项目顶层目录（D:\my_project）执行以下命令运行脚本：

  py -m src_2.second
  

  这种方式会自动将项目顶层目录加入sys.path，符合Python包的规范。

方法2：在入口脚本中动态添加路径 #

如果坚持直接运行src_2/second.py，可以在脚本开头添加代码，手动将项目顶层目录加入sys.path：

import sys
import os
# 获取当前脚本的绝对路径，向上回溯一层得到项目顶层目录
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(project_root)

# 现在可以正常导入
from src_1 import first

二、PyInstaller打包为两个独立exe #

先确保本地运行脚本时导入正常，再针对两个入口分别打包：

1. 推荐的项目结构调整（可选但更规范） #

将入口逻辑抽离到项目根目录的独立脚本中，结构如下：

my_project/
   __init__.py
   src_1/
      __init__.py
      first.py
   src_2/
      __init__.py
      second.py
   run_processor.py  # 对应processor.exe的入口
   run_gui.py        # 对应gui.exe的入口

• run_processor.py内容示例：

  from src_2 import second
  if __name__ == "__main__":
      second.run()  # 假设second.py中有run()作为核心逻辑入口
  

• run_gui.py同理，导入对应GUI模块并启动。

2. 执行打包命令 #

从项目顶层目录运行以下命令，分别打包两个exe：

• 打包processor.exe：

  pyinstaller --onefile --name processor run_processor.py
  

• 打包gui.exe：

  pyinstaller --onefile --name gui run_gui.py
  

3. 处理依赖路径问题 #

如果打包时出现模块找不到的情况，可通过--paths参数指定项目顶层目录：

pyinstaller --onefile --name processor --paths D:\my_project run_processor.py

打包完成后，exe文件会生成在项目根目录的dist文件夹中。

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