根本原因是cx_freeze无法自动识别二进制扩展隐式依赖的dll，需在setup.py中通过include_files手动指定路径或使用hook脚本自动注入依赖。
为什么cx_Freeze打包后运行报 ImportError: DLL load failed？
根本原因不是缺 Python 模块，而是 Windows 找不到某个 .dll 文件——通常是 Microsoft Visual C++ 运行时（如 vcruntime140.dll）、OpenSSL 相关 DLL（libcrypto-1_1.dll、libssl-1_1.dll），或者第三方扩展模块（如 numpy、pydantic 依赖的 pydantic_core.pyd）自带的动态链接库没被正确复制进构建目录。
cx_Freeze 默认只扫描 Python 源码 import 语句，对二进制扩展中隐式加载的 DLL 完全不感知，也不会自动把它们拖进 build/ 目录。
如何让 cx_Freeze 手动包含缺失的 DLL？
在 setup.py 的 build_exe 配置里用 include_files 显式指定路径。关键是要先定位到那些 DLL 实际在哪：
- 查 Python 环境里已有的 DLL：运行
python -c "import numpy; print(numpy.__file__)"，然后顺着路径往上翻找libs/或同级.dll文件 - 用
depends.exe（旧版）或Dependencies工具打开报错的.pyd文件，看它依赖哪些 DLL - 常见位置包括：
Python\DLLs\、Python\libs\、site-packages\numpy\.libs\、site-packages\pydantic\_pydantic_core.cp39-win_amd64.pyd所在目录
示例配置片段：
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
build_exe_options = {
"include_files": [
(r"C:\Python39\DLLs\vcruntime140.dll", "vcruntime140.dll"),
(r"C:\Python39\Lib\site-packages\numpy\.libs\*.dll", "numpy/.libs/"),
],
}
怎样避免反复手动找 DLL？用 hooks 预先注入依赖
cx_Freeze 支持自定义 hook 脚本，在打包前自动识别并添加特定包所需的 DLL。比如为 numpy 写一个 hook-numpy.py 放在项目根目录，并在 setup.py 中通过 hooks 参数启用：
- hook 文件名必须是
hook-{package_name}.py，且放在setup.py同级或cx_Freeze.hooks可导入路径下 - hook 内部要调用
finder.include_files()或finder.add_dll_excludes()，不能只写路径字符串 - 官方已有部分 hook（如
hook-numpy.py），但版本更新快，建议从 cx_Freeze GitHub hooks 目录 复制最新版
如果用了 pydantic 或 httpx，它们底层用的 certifi CA 证书和 OpenSSL DLL 也得一并处理——hook 比硬编码 include_files 更可持续。
打包后怎么快速验证 DLL 是否齐全？
别等双击 exe 报错才排查。用以下两步快速兜底：
- 用
Dependencies（推荐新版 Dependencies GUI）打开生成的.exe，看红色标记的缺失项；注意切换到“Flat view”模式，否则嵌套依赖容易漏看 - 在命令行进到
build/exe.win-amd64-3.9/目录，执行your_app.exe --debug（如果应用支持 debug 模式），或加-v参数看详细加载过程 - 临时把整个
build/目录拷到一台干净 Win10/Win11 虚拟机里运行，比本机测试更真实——本机可能因为装了 VS 或 Python 而掩盖问题
真正麻烦的不是找不到某个 DLL，而是多个包各自带同名不同版本的 DLL（比如两个 msvcp140.dll），cx_Freeze 默认不会去重或覆盖，得靠 replace_files=True 或手动控制顺序。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
