Swift中PythonKit调用XlsxWriter遇模块缺失：导出可执行文件故障排查

1. pip与pip3的环境差异 #

macOS默认预装Python2和Python3，pip对应Python2的包管理工具，pip3对应Python3，二者的模块安装目录（site-packages）完全独立：

• PyCharm中你配置的是Python3解释器，pip3安装的XlsxWriter会被放在Python3的site-packages目录，因此能正常识别。
• 初始Swift中PythonKit默认调用系统Python2，该环境未安装XlsxWriter，所以报错找不到模块。
• 改用pip安装后，XlsxWriter被安装到Python2的site-packages，此时Xcode运行时PythonKit调用的是系统Python2，因此能正常加载模块。

2. 开发环境与独立可执行文件的环境隔离 #

Xcode开发运行和导出独立可执行文件时，Python的运行环境存在本质差异：

• Xcode开发模式下，App会继承当前开发用户的环境变量（如PATH、PYTHONPATH），能正确定位到Python2的site-packages目录，因此可以找到XlsxWriter。
• 导出的独立可执行文件运行时，会以系统级的受限环境（比如通过LaunchServices启动）运行，此时Python的模块搜索路径可能不包含用户级的site-packages，或者PATH中Python的路径与开发环境不一致，导致无法找到已安装的XlsxWriter模块。

3. 全局依赖未嵌入App包 #

XlsxWriter是通过系统包管理工具安装的全局模块，并未被嵌入到导出的App包中。即使在同一机器，受限的运行环境也可能无法访问全局安装的模块；若在其他未安装XlsxWriter的机器上运行该可执行文件，同样会出现找不到模块的错误。

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