使用cx_Freeze编译Python3项目时自定义模块导入失败求助

我来帮你排查并解决这个导入失败的问题，这是cx_Freeze编译时常见的模块路径识别问题：

1. 修正导入语句的写法 #

你在run.py里用的import config属于隐式相对导入，这种写法在直接运行脚本时可能正常，但cx_Freeze编译后，模块的命名空间结构会发生变化，很容易导致找不到模块。

把导入语句改成以下两种方式之一：

• 相对导入（推荐）：因为config.py和run.py在同一目录下，用相对导入更稳妥：

  from . import config
  

• 绝对导入：明确指定模块的完整路径：

  from app.code import config
  

2. 调整setup.py的配置细节 #

你的setup.py有几个可以优化的点，帮cx_Freeze更准确识别模块：

• packages参数应该用Python模块的点式命名（不是路径分隔符），虽然当前写法可能生效，但规范写法是：

  packages = ["app.code"]
  

• 在includes里明确添加需要的模块，避免cx_Freeze遗漏：

  includes = ["app.code.config"]
  

• 确保path包含项目根目录，让cx_Freeze能正确定位到app模块：

  path = sys.path + [os.path.abspath(os.path.dirname(__file__))]
  

3. 调试编译后的路径（可选排查步骤） #

如果还是有问题，可以在run.py开头加一段调试代码，查看编译后程序的路径列表，确认模块所在目录是否被包含：

import sys
print("当前程序路径列表：", sys.path)
input("按回车键继续...")

运行编译后的exe文件，控制台会打印出当前的sys.path，检查app/code或对应的模块目录是否在列表中。如果不在，就需要在setup.py的path参数里手动添加这个路径。

4. 确认__init__.py的有效性 #

确保app/code/__init__.py存在（你的目录结构里已经有了），而且文件是空的或者没有导入错误的代码——这个文件是Python识别该目录为模块的必要标志。

完成以上步骤后，重新执行编译命令，应该就能解决config模块的导入问题了。

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