如何将多个Python文件编译为单个.pyd文件以优化启动速度？

核心思路 #

通过Cython的Extension配置，把所有需要编译的.py源文件合并指定为一个扩展模块的源码，最终编译出单个.pyd文件，减少DLL加载次数，缓解首次启动慢的问题。

具体操作步骤 #

1. 调整项目结构（可选但推荐）

把所有要编译的.py文件集中到一个子目录（比如src），然后创建一个入口模块（比如main_module.py）统一导入所有子模块：

# src/main_module.py
from . import module1, module2, module3  # 替换为你实际的子模块名

如果原有模块使用相对导入，确保路径层级匹配项目结构。

2. 编写Cython编译脚本setup.py

这个脚本是核心，负责配置编译参数、指定所有要打包的源文件：

from setuptools import setup, Extension
from Cython.Build import cythonize
import sys
import os

# 获取PySide2的依赖路径
pyside_root = os.path.dirname(sys.executable) + '/Lib/site-packages/PySide2'
pyside_include = os.path.join(pyside_root, 'include')
pyside_lib = pyside_root

# 定义扩展模块：将所有源文件打包为单个.pyd
ext_modules = [
    Extension(
        "my_app_core",  # 最终生成的.pyd文件名（会输出my_app_core.pyd）
        sources=[
            "src/main_module.py",
            "src/module1.py",
            "src/module2.py",
            "src/module3.py"  # 追加所有需要编译的.py文件
        ],
        include_dirs=[pyside_include],
        library_dirs=[pyside_lib],
        libraries=["shiboken2", "Qt5Core", "Qt5Gui", "Qt5Widgets"],  # 根据你的PySide2组件添加对应库
        language="c++",  # 必须指定C++，适配PySide2的底层C++实现
        extra_compile_args=["/O2", "/MT"] if sys.platform == "win32" else [],  # Windows下优化编译，用静态多线程库
        extra_link_args=[f'/LIBPATH:{pyside_lib}'] if sys.platform == "win32" else []
    )
]

setup(
    name="my_app_core",
    ext_modules=cythonize(ext_modules, language_level=3)  # language_level对应你的Python版本（3.x填3）
)

3. 处理PySide2的特殊编译要求

如果你的模块中使用了PySide2的信号槽、自定义QObject子类等，需要在每个.py文件顶部添加Cython声明：

# cython: language_level=3
# cython: c_string_type=str, c_string_encoding=utf-8
from PySide2.QtCore import QObject, Signal, Slot

这能确保Cython正确识别Qt的C++类型，避免编译报错。

4. 执行编译

在命令行运行以下命令，生成单个.pyd文件：

python setup.py build_ext --inplace

编译完成后，当前目录会出现my_app_core.pyd，这就是合并后的编译产物。

5. 替换项目中的导入逻辑

原来的代码中如果是import module1，现在改为：

from my_app_core import module1

或者直接导入整个核心模块：

import my_app_core
# 使用时调用my_app_core.module1.xxx

额外优化建议 #

• 编译时的/O2参数会开启编译优化，提升.pyd的运行效率；
• 剔除不需要的模块，缩小.pyd体积，进一步减少加载时间；
• 可以用UPX工具压缩PySide2的核心DLL和生成的.pyd，降低磁盘IO开销；
• 针对首次启动慢的问题，还可以写一个轻量的开机启动脚本，提前加载必要的Qt DLL到系统缓存。

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