/WHOLEARCHIVE（包括所有库对象文件）

  • 项目

强制链接器将静态库中的所有对象文件包含在链接的可执行文件中。

语法

/WHOLEARCHIVE
/WHOLEARCHIVE:library

参数

库
静态库的可选路径名称。 链接器包含此库中的每个对象文件。

注解

/WHOLEARCHIVE 选项强制链接器包含指定静态库中的每个对象文件，或者如果未指定任何库，则包含为 LINK 命令指定的所有静态库中的对象文件。 若要为多个库指定 /WHOLEARCHIVE 选项，可以在链接器命令行上使用多个 /WHOLEARCHIVE 开关。 默认情况下，仅当链接器导出可执行文件中其他对象文件引用的符号时，链接器才会在链接输出中包含对象文件。 /WHOLEARCHIVE 选项使链接器将静态库中存档的所有对象文件视为在链接器命令行上单独指定的文件。

/WHOLEARCHIVE 选项可用于从静态库重新导出所有符号。 这样，就可以确保在从多个静态库创建组件时包含所有库代码、资源和元数据。 在创建包含要导出的 Windows 运行时组件的静态库时，如果看到警告 LNK4264，请在将该库链接到其他组件或应用时使用 /WHOLEARCHIVE 选项。

Visual Studio 2015 Update 2 中引入了 /WHOLEARCHIVE 选项。

在 Visual Studio 中设置此链接器选项

  1. 打开项目“属性页” 对话框。 有关详细信息，请参阅在 Visual Studio 中设置 C++ 编译器和生成属性。

  2. 选择“配置属性”>“链接器”>“命令行”属性页 。

  3. 将 /WHOLEARCHIVE 选项添加到“附加选项”文本框。

另请参阅

MSVC 链接器参考
MSVC 链接器选项