将 EXE 和 DLL 打包成单一可执行文件

在 Windows 开发中，经常遇到这样的需求：把一个依赖多个 DLL 的程序打包成一个独立的 EXE，方便分发和部署，不需要用户安装额外的依赖。本文介绍几种主流的打包方案及其优缺点。

背景

Windows 程序的 DLL 依赖问题由来已久。一个典型的 C++ 程序可能依赖：

Visual C++ 运行时（msvcp140.dll、vcruntime140.dll）
第三方库（Qt5Core.dll、openssl.dll 等）
自己开发的辅助 DLL

部署时如果漏了某个 DLL，用户会看到令人困惑的"找不到 xxx.dll"错误。

单文件打包的目标是：将所有依赖嵌入 EXE，用户只需要一个文件。

方案一：静态链接（最根本的解决方案）

如果你有源码控制权，最干净的方案是直接静态链接。

C/C++ 项目静态链接

# CMakeLists.txt

# 静态链接 MSVC 运行时
set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")

# 或者设置编译选项
# Release: /MT
# Debug:   /MTd
target_compile_options(myapp PRIVATE
    $<$<CONFIG:Release>:/MT>
    $<$<CONFIG:Debug>:/MTd>
)

Visual Studio 项目设置：

项目属性 → C/C++ → 代码生成 → 运行库
选择 多线程 (/MT) 而不是 多线程 DLL (/MD)

优缺点

优点	缺点
无需额外工具	文件体积增大
运行性能最好	第三方 DLL 可能不提供静态库
无运行时解压开销	某些库（如 OpenSSL）不推荐静态链接

方案二：Enigma Virtual Box（免费工具）

Enigma Virtual Box 是一款免费的打包工具，可以将 DLL 嵌入 EXE。

使用步骤

下载并安装 Enigma Virtual Box
打开主程序，点击 Browse 选择目标 EXE
点击 Add 添加所有 DLL 文件
（可选）勾选 Compress Files 压缩嵌入文件
点击 Process 生成打包后的 EXE

工作原理

Enigma Virtual Box 在 EXE 中嵌入一个虚拟文件系统。程序运行时，它拦截 Windows 的文件 API 调用，将对 DLL 文件的访问重定向到内存中的虚拟文件系统。

原始 EXE + DLL1 + DLL2 → 打包后 EXE
                              ├── 原始程序逻辑
                              ├── 虚拟文件系统层
                              ├── 嵌入的 DLL1
                              └── 嵌入的 DLL2

注意事项

某些加壳/加密保护与 Enigma Virtual Box 冲突
杀毒软件可能对打包后的 EXE 有误报（因为修改了 PE 结构）
不支持 64 位 DLL 内嵌到 32 位 EXE（类型必须匹配）

方案三：IExpress（Windows 内置）

Windows 自带的 IExpress 工具可以创建自解压安装包。

iexpress

这不是严格意义的单文件运行，而是运行前解压到临时目录。适合简单的分发场景。

方案四：Resource Hacker 手动嵌入

对于有特殊需求的场景，可以手动将 DLL 作为资源嵌入 EXE，然后在程序启动时释放。

嵌入 DLL 到资源

使用 Resource Hacker 或在代码中通过 rc 文件定义：

// resources.rc
IDR_DLL_FOO   RCDATA   "foo.dll"
IDR_DLL_BAR   RCDATA   "bar.dll"

运行时释放并加载

#include <windows.h>
#include <string>

bool ExtractAndLoadDll(HMODULE hModule, int resourceId, const wchar_t* dllName) {
    HRSRC hRes = FindResource(hModule, MAKEINTRESOURCE(resourceId), RT_RCDATA);
    if (!hRes) return false;
    
    HGLOBAL hData = LoadResource(hModule, hRes);
    if (!hData) return false;
    
    DWORD size = SizeofResource(hModule, hRes);
    void* pData = LockResource(hData);
    
    // 获取临时目录
    wchar_t tempPath[MAX_PATH];
    GetTempPathW(MAX_PATH, tempPath);
    
    std::wstring dllPath = std::wstring(tempPath) + dllName;
    
    // 写入临时文件
    HANDLE hFile = CreateFileW(dllPath.c_str(), GENERIC_WRITE, 0, NULL,
                                CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
    if (hFile == INVALID_HANDLE_VALUE) return false;
    
    DWORD written;
    WriteFile(hFile, pData, size, &written, NULL);
    CloseHandle(hFile);
    
    // 加载 DLL
    return LoadLibraryW(dllPath.c_str()) != NULL;
}

int WINAPI WinMain(HINSTANCE hInstance, ...) {
    // 在程序启动时释放并加载 DLL
    ExtractAndLoadDll(hInstance, IDR_DLL_FOO, L"foo.dll");
    ExtractAndLoadDll(hInstance, IDR_DLL_BAR, L"bar.dll");
    
    // 正常程序逻辑
    // ...
}

清理临时文件

// 程序退出时清理
void Cleanup() {
    wchar_t tempPath[MAX_PATH];
    GetTempPathW(MAX_PATH, tempPath);
    
    DeleteFileW((std::wstring(tempPath) + L"foo.dll").c_str());
    DeleteFileW((std::wstring(tempPath) + L"bar.dll").c_str());
}

方案五：.NET 应用使用 ILMerge / Costura.Fody

对于 .NET 应用，有专门的工具：

ILMerge（微软官方）

# 安装
dotnet tool install -g ilmerge

# 合并
ILMerge /out:merged.exe app.exe dep1.dll dep2.dll

Costura.Fody（推荐，自动化）

<!-- NuGet 安装 -->
<PackageReference Include="Costura.Fody" Version="5.7.0" />
<PackageReference Include="Fody" Version="6.6.0" />

安装后无需额外配置，编译时自动将引用的 DLL 嵌入 EXE。

<!-- FodyWeavers.xml -->
<Weavers xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="FodyWeavers.xsd">
  <Costura />
</Weavers>

方案六：Python/其他脚本语言打包

PyInstaller（Python）

pip install pyinstaller

# 打包为单文件
pyinstaller --onefile --windowed myapp.py

# 添加数据文件
pyinstaller --onefile --add-data "config.ini;." myapp.py

Nuitka（Python 编译器，效果更好）

pip install nuitka

python -m nuitka --onefile --windows-disable-console myapp.py

踩坑与注意事项

坑 1：DLL 运行时还是找不到

某些 DLL 通过系统 API LoadLibrary 在运行时动态加载，不是在程序启动时加载的。Enigma Virtual Box 的虚拟文件系统可以拦截这类调用，但手动嵌入方式需要提前加载所有 DLL。

// 确保在任何代码执行前加载所有 DLL
int main() {
    LoadLibraryW(L"foo.dll");  // 必须在其他初始化之前
    // ...
}

坑 2：64 位与 32 位混用

64 位 EXE 只能加载 64 位 DLL
32 位 EXE 只能加载 32 位 DLL
打包工具必须与目标程序位数一致

坑 3：杀毒误报

自解压/嵌入 DLL 的 EXE 经常被杀毒软件误报为病毒。

解决方案：

对 EXE 进行代码签名（Code Signing Certificate）
向主流杀毒厂商提交误报申诉

坑 4：临时文件目录权限

在受限环境（企业域机器）下，用户可能对某些临时目录没有写权限。

// 尝试多个临时目录
std::vector<std::wstring> tempDirs = {
    GetTempPath(),
    GetAppDataPath(),
    GetCurrentDirectory()
};

坑 5：Enigma Virtual Box 与 .NET 不兼容

Enigma Virtual Box 主要针对 native（C/C++）程序，对 .NET 应用支持有限。.NET 应用请使用 Costura.Fody 或 ILMerge。

方案选择指南

你的程序是？
├── C/C++ 原生程序
│   ├── 有源码 → 静态链接（/MT 编译选项）
│   └── 无源码 / 第三方 DLL → Enigma Virtual Box
├── .NET 程序
│   ├── .NET Framework → ILMerge 或 Costura.Fody
│   └── .NET 5/6/7 → dotnet publish --self-contained
└── Python 程序
    ├── 简单场景 → PyInstaller --onefile
    └── 性能要求高 → Nuitka --onefile

总结

将 EXE 和 DLL 合并为单文件有多种方案：

静态链接：最干净，推荐首选，但需要源码控制权
Enigma Virtual Box：免费，操作简单，适合 native 程序
资源嵌入：灵活，但需要手动编写释放逻辑
Costura.Fody：.NET 应用的最佳选择，自动化程度高
PyInstaller/Nuitka：Python 应用的标准方案

根据你的技术栈和具体需求选择合适的方案，大多数情况下静态链接或 Enigma Virtual Box 足以解决问题。