PyCharm中两台Win10设备Python模块导入及PyInstaller打包差异问题

算力阿峰

2026-8-6

跨设备PyCharm与PyInstaller模块导入差异解决方案

核心原因：PyCharm源代码根配置与sys.path差异

两台设备的导入行为差异完全由PyCharm的**Sources Root（源代码根）**和运行工作目录设置不同导致，具体分析如下：

C:\Users\username\PycharmProjects\pythonProject\python_programming_demo_app-0.0.1
└── dir1
    ├── main.py
    └── dir2
        └── A.py

笔记本（PC1）：PyCharm同时将根目录python_programming_demo_app-0.0.1和dir1目录标记为了Sources Root，导致Python的sys.path同时包含这两个目录：
- from dir1.dir2 import A：基于根目录的绝对导入，Python从根目录找到dir1，再定位到dir2下的A模块
- from dir2 import A：基于dir1目录的导入，dir2作为dir1的子目录，被sys.path直接覆盖，因此能正常导入
台式机（PC2）：PyCharm仅将dir1标记为Sources Root，sys.path只包含dir1：
- from dir2 import A：正常生效，dir2属于dir1的子目录，在sys.path覆盖范围内
- from dir1.dir2 import A：报错，因为根目录不在sys.path中，Python无法识别顶级模块dir1

PyInstaller打包时默认以**脚本所在目录（即dir1）**为核心依赖目录，仅识别代码中明确关联的项目内模块：

PC1打包写法1有效：from dir1.dir2 import A明确告知PyInstallerdir2是dir1的子模块，打包时会完整保留dir1目录结构，运行时能正常定位依赖
PC1打包写法2无效：from dir2 import A在PyCharm运行时依赖sys.path中的dir1，但PyInstaller可能误判dir2为第三方模块，未将其正确打包进exe，导致运行时触发no module named dir2
PC2打包写法2有效：由于PyCharm仅将dir1设为Sources Root，代码中from dir2 import A明确指向dir1下的子模块，PyInstaller能正确识别并打包dir2，运行时无问题

要让两台设备的导入和打包行为一致，按以下步骤操作：

统一PyCharm的Sources Root：在两台设备上，仅将dir1目录标记为Sources Root（右键dir1 → Mark Directory as → Sources Root）
规范导入写法：
- 推荐使用相对导入：在main.py中写from .dir2 import A（.代表当前目录dir1）
- 若使用绝对导入，可在代码开头手动添加根目录到sys.path：
```
import sys
import os
# 将根目录加入sys.path
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
```
  之后即可使用from dir1.dir2 import A
PyInstaller打包时显式指定路径：打包时添加--paths参数指定根目录，确保所有模块被正确识别：
```
pyinstaller --paths "C:\Users\username\PycharmProjects\pythonProject\python_programming_demo_app-0.0.1" main.py
```

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