/INCREMENTAL(增量链接)

/INCREMENTAL[:NO]

备注

/INCREMENTAL 选项控制链接器如何处理增量链接。

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

增量链接的程序在功能上等效于非增量链接的程序。 不过,因为它是为后面的增量链接而准备的,所以增量链接的可执行 (.exe) 文件或动态链接库 (DLL):

  • 大于非增量链接的程序,因为有代码和数据的填充。 (填充允许链接器增加函数和数据的大小而不用重新创建 .exe 文件。)

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

    备注

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

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

大多数程序都可以增量链接。 然而,某些更改太大,某些选项与增量链接不兼容。 如果指定了任何下列选项,则 LINK 执行完全链接:

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

  • 选定 /OPT:REF

  • 选定 /OPT:ICF

  • 选定 /ORDER

指定 /DEBUG 时暗含 /INCREMENTAL。

另外,如果发生以下任何情况,则 LINK 执行完全链接:

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

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

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

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

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

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

  • 更改用 /Yu /Z7 选项编译的对象。

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

  1. 打开项目的**“属性页”**对话框。 有关详细信息,请参见设置 Visual C++ 项目属性

  2. 单击“链接器”文件夹。

  3. 单击“常规”属性页。

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

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

请参见

参考

设置链接器选项

链接器选项