Pyinstaller打包时报错ModuleNotFoundError: No module named 'ctypes'求助

错误成因 #

• ctypes属于Python标准库自带模块，正常运行环境下不会出现原生缺失问题，该报错的核心触发原因是Pyinstaller的隐式导入检测逻辑无法识别代码中from ctypes import *的通配符导入声明，打包时未将ctypes对应的依赖文件纳入最终的可执行文件包中
• 少数场景下该报错由本地Python环境异常导致：部分精简绿色版Python、嵌入式定制版Python会主动移除ctypes等不常用的标准库组件，导致运行时和打包时都无法找到该模块

修复方案 #

• 第一步先校验本地Python环境完整性：
  打开终端执行命令 python -c "import ctypes;print(ctypes.__file__)"，如果执行时报错，说明当前Python环境本身缺失ctypes组件，直接卸载现有Python，重新安装Python官方发布的完整版安装包即可解决。
• 环境校验正常的情况下，打包时手动声明隐藏导入即可解决：
  在原有Pyinstaller打包命令中添加--hidden-import ctypes参数，示例命令如下：
  pyinstaller -F 你的脚本文件名.py --hidden-import ctypes
• 如果你使用spec配置文件打包，直接修改spec中的对应配置项即可：
  找到spec文件中hiddenimports = []的配置行，修改为hiddenimports = ["ctypes"]，保存后使用spec文件执行打包：pyinstaller 你的配置文件名.spec
• 异常排查补充：如果上述操作均无效，确认你执行打包的Pyinstaller和代码运行所用的Python解释器属于同一个环境（尤其是使用虚拟环境的场景），跨环境调用Pyinstaller会出现依赖错位，导致已声明的导入仍无法识别。

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