MacOS下PyInstaller打包含tkmacosx的Python程序时遭遇colour模块缺失问题求助

我之前也遇到过PyInstaller打包时漏抓隐式依赖的情况，针对你这个找不到colour模块的问题，给你几个可行的解决方案，按顺序试试：

1. 显式导入依赖模块 #

在你的主脚本（也就是运行的file.py）最开头加上一行：

import colour

PyInstaller是通过扫描脚本里的导入语句来收集依赖的，tkmacosx内部导入colour属于隐式依赖，PyInstaller可能没检测到，显式导入后它就会自动把colour打包进去了。

2. 打包时用--hidden-import指定缺失模块 #

如果显式导入没用，直接在打包命令里强制告诉PyInstaller要包含colour：

pyinstaller --hidden-import=colour file.py

这个参数专门用来处理那些PyInstaller自动扫描不到的隐式依赖，非常实用。

3. 确认PyInstaller使用的Python版本和你装colour的版本一致 #

系统里多Python版本共存时，很容易出现PyInstaller绑定的版本和你日常开发用的版本不一致的情况。你可以先检查PyInstaller所属的Python版本：

which pyinstaller
# 比如输出可能是 /Library/Frameworks/Python.framework/Versions/3.9/bin/pyinstaller

如果发现它属于你没装colour的版本，就用对应的Python版本重新安装PyInstaller和colour：

# 假设是3.9版本的PyInstaller
python3.9 -m pip install pyinstaller colour

然后用这个版本的PyInstaller打包：

python3.9 -m pyinstaller --hidden-import=colour file.py

4. 用.spec文件手动配置依赖 #

如果上面的方法都不行，可以生成一个.spec文件来更精细地控制打包过程：

1. 生成.spec文件：

pyi-makespec file.py

2. 打开生成的file.spec，找到hiddenimports这一行，把colour添加到列表里：

hiddenimports=['colour'],

3. 用.spec文件执行打包：

pyinstaller file.spec

另外你之前加的sys.path.append代码在打包后作用不大，因为PyInstaller会把所有依赖打包到一个临时目录，路径结构和本地开发环境完全不同，不用靠这个来解决依赖问题。

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