/INCREMENTAL（增量链接）

  • 项目

指定是进行增量链接还是始终执行完整链接。

语法

/INCREMENTAL[:NO]

备注

/INCREMENTAL 链接器选项控制链接器处理增量链接的方式。

默认情况下，链接器以增量模式运行。 若要重写默认增量链接，请指定 /INCREMENTAL:NO。

增量链接的程序在功能上等效于非增量链接的程序。 但是，因为它是为后面的增量链接而准备的，所以增量链接的可执行文件、静态库或动态链接库文件：

  • 大于非增量链接的程序，因为有代码和数据的填充。 填充使链接器可以增加函数和数据的大小而不用重新创建该文件。

  • 可以包含跳转 thunk 以处理函数重定位到新地址。

    注意

    为了确保最终发布版本不包含填充或 thunk，请非增量链接你的程序。

若要增量链接而不管默认值，请指定 /INCREMENTAL。 选定此选项后，如果链接器无法增量链接，它就会发出警告，然后非增量链接程序。 某些选项和情况重写 /INCREMENTAL。

大多数程序都可以增量链接。 但是，某些更改太大，还有某些选项与增量链接不兼容。 如果指定了以下任一选项，则 LINK 执行完全链接：

  • 未选择增量链接 (/INCREMENTAL:NO)

  • /OPT:REF 处于选中状态

  • /OPT:ICF 处于选中状态

  • /OPT:LBR 处于选中状态

  • /ORDER 处于选中状态

指定 /DEBUG 时隐式使用 /INCREMENTAL。

此外，如果发生以下任何情况，则 LINK 执行完全链接：

  • 缺少增量状态 (.ilk) 文件。 （LINK 将创建新的 .ilk 文件，以便为后面的增量链接作准备。）

  • 对 .ilk 文件没有写入权限。 （LINK 忽略 .ilk 文件并进行非增量链接。）

  • 缺少 .exe 或 .dll 输出文件。

  • 已更改 .ilk、.exe 或 .dll 的时间戳。

  • 更改了 LINK 选项。 大多数 LINK 选项在各生成间更改时会导致完全链接。

  • 添加或省略了对象 (.obj) 文件。

增量链接可创建或更新增量链接数据库 .ilk 文件。 可以使用 /ILK（名称增量数据库文件）链接器选项指定此文件的名称和位置。 有关 .ilk 文件的详细信息，请参阅用作链接器输入的 .ilk 文件。

在 Visual Studio 开发环境中设置此链接器选项

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

  2. 选择“配置属性”>“链接器”>“常规”属性页。

  3. 修改“启用增量链接”属性。

以编程方式设置此链接器选项

  1. 请参阅 LinkIncremental。

另请参阅

MSVC 链接器参考
MSVC 链接器选项
用作链接器输入的 .ilk 文件