/INCREMENTAL(增量链接)

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

语法

]$

备注

/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 文件