PyInstaller OneDir模式多依赖脚本exe模块导入失效求助

核心问题分析 #

OneFile模式能正常运行，说明代码逻辑和依赖本身无问题，OneDir模式的故障大概率源于PyInstaller依赖分析不完整、运行时路径错误，或是打包命令冗余参数导致的导入逻辑混乱。

具体解决方案 #

1. 简化打包命令，仅指定入口文件 #

无需将Support系列文件全部列在打包命令中，PyInstaller会自动分析Main.py的依赖链（Main→Support1→Support2/Support3），冗余指定反而可能破坏导入逻辑。执行以下命令：

pyinstaller --onedir -w Main.py

2. 强制声明隐藏导入（应对依赖分析遗漏） #

若PyInstaller的静态分析未识别到Support2/Support3（比如存在动态导入、条件导入场景），用--hidden-import参数手动声明依赖：

pyinstaller --onedir -w --hidden-import Support2 --hidden-import Support3 Main.py

3. 开启控制台查看错误日志 #

-w模式会隐藏控制台，导致报错信息无法排查。先去掉-w参数打包，通过控制台获取错误详情：

pyinstaller --onedir Main.py

在命令行中执行dist/Main/Main.exe，查看控制台输出的错误（如模块找不到、文件路径错误等），这是定位问题最直接的方式。

4. 修正运行时工作目录 #

如果程序依赖相对路径读取文件，或模块导入依赖当前目录，需确保运行时工作目录为exe所在目录。在Main.py开头添加以下代码：

import os
import sys

# 切换到exe所在目录
if hasattr(sys, '_MEIPASS'):
    os.chdir(sys._MEIPASS)
else:
    os.chdir(os.path.dirname(os.path.abspath(__file__)))

5. 禁止手动复制原py文件到exe目录 #

PyInstaller已将编译后的模块打包到OneDir的子目录中，手动放置原py文件会导致导入优先级混乱，反而引发问题。

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