/MP(使用多个进程生成)

/MP 选项可缩短在命令行上编译源文件的总时间。 /MP 选项将使编译器在每个单独进程中创建一个或多个自身副本。 然后,这些实例将同时编译源文件。 在某些情况下,可以显著减少生成源文件的总时间。

语法

]$

参数

processMax
(可选)编译器可以创建的最大进程数。

processMax 参数的范围必须介于 1 到 65536。 否则,编译器会发出警告消息 D9014,忽略 processMax 参数,并假定最大进程数为 1。

如果省略 processMax 参数,编译器会从计算机的操作系统中检索 有效处理器 的数目,并为每个处理器创建一个进程。

备注

/MP 编译器选项可以在编译多个文件时显著缩短生成时间。 为了缩短生成时间,编译器最多会创建 processMax 个其自身的副本,然后同时使用这些副本来编译您的源文件。 /MP 选项适用于编译,但不适用于链接或链接时间代码生成。 默认情况下,/MP 选项是关闭的。

生成时间的改善取决于计算机上的处理器数、要编译的文件数以及系统资源可用性,如 I/O 容量。 试验 /MP 选项,以确定生成特定项目的最佳设置。 获取帮助你做出决定的建议,请参阅 准则

不兼容的选项和语言功能

/MP 选项与一些编译器选项和语言功能不兼容。 如果将不兼容的编译器选项与 /MP 选项一起使用,编译器会发出警告 D9030 并忽略 /MP 选项。 如果你使用不兼容的语言功能,编译器会发出错误 C2813,然后结束或继续,具体取决于当前编译器警告等级选项。

注意

大多数选项不兼容,因为如果允许这些选项,并发执行的编译器会将其输出同时写入控制台或特定文件。 因此,输出会互相混合,产生混淆。 在某些情况下,选项组合会使性能变得更糟。

下表列出了与 /MP 选项不兼容的编译器选项和与语言功能:

选项或语言功能 说明
#import 预处理器指令 将类型库中的类型转换为 C++ 类,然后将这些类写入头文件。
%> 将预处理器输出复制到标准输出 (stdout)。
/Gm 已弃用。 启用增量重新生成。
/showIncludes 将包含文件的列表写入标准错误 (stderr)。
/Yc 编写预编译头文件。

诊断消息

如果指定与 /MP 选项不兼容的选项或语言功能,将收到一条诊断消息。 下表列出了编译器的消息和行为:

诊断消息 说明 编译器行为
C2813 #import 指令与 /MP 选项不兼容。 除非另外指定了 编译器警告等级 选项,否则编译终止。
D9014 processMax 参数指定了无效值。 编译器将忽略无效值,并假定值为 1。
D9030 指定选项与 /MP 不兼容。 编译器忽略 /MP 选项。

准则

测量性能

使用总生成时间来测量性能。 可以使用物理时钟测量生成时间,或使用能够计算生成启动和停止之间的时间差的软件。 如果计算机具有多个处理器,物理时钟测量结果可能会比软件时间测量结果更准确。

有效处理器

计算机的每个物理处理器可具有一个或多个虚拟处理器,又称为有效处理器。 每个物理处理器可具有一个或多个核心,如果操作系统为核心启用了超线程,则类似于每个核心具有两个虚拟处理器。

例如,如果某计算机具有一个物理处理器,该物理处理器有一个核心,并且禁用了超线程,则这台计算机具有一个有效处理器。 相反,如果某计算机具有两个物理处理器,每个物理处理器有两个核心,且所有核心均已启用超线程,则这台计算机具有八个有效处理器。 也就是说,(8 个有效处理器)=(2 个物理处理器)x(2 个核心/物理处理器)x(2 个有效处理器/核心,由于启用了超线程)。

如果省略 /MP 选项中的 processMax 参数,编译器会从操作系统获取有效处理器数目,然后为每个有效处理器创建一个进程。 但是,编译器无法保证特定处理器上执行的是哪个进程;该决策由操作系统做出。

进程数

编译器计算将用于编译源文件的进程数。 该值是在命令行上指定的源文件数和使用 /MP 选项显式或隐式指定的进程数中较小的值。 如果提供 /MP 选项的 processMax 参数,可以显式设置最大进程数。 如果省略 processMax 参数,则可以使用默认值,默认值等于计算机中的有效处理器数。

例如,假设指定以下命令行:

cl /MP7 a.cpp b.cpp c.cpp d.cpp e.cpp

在本例中,编译器使用五个进程,因为它是五个源文件和最多七个进程中的较小值。 或者,假设计算机具有两个有效处理器,并且指定以下命令行:

cl /MP a.cpp b.cpp c.cpp

在本例中,操作系统报告两个处理器,因此编译器在计算过程中使用两个进程。 因此,编译器将使用两个进程执行生成,因为它是两个进程和三个源文件中的较小值。

源文件和生成顺序

可能无法按照源文件显示在命令行上的相同顺序对源文件进行编译。 虽然编译器创建了一组包含编译器副本的进程,但由操作系统安排每个进程的执行时间。 /MP 选项无法保证按特定顺序编译源文件。

在有可用于编译源文件的进程时编译源文件。 如果文件多于进程数,则可用进程会编译第一组文件。 当进程处理完以前的文件并可处理其中一个剩余文件时,将处理剩余的文件。

不要在命令行上多次指定同一源文件。 例如,如果某工具自动创建基于项目中依赖项信息的 makefile,可能会出现多个规范。 如果未指定 /MP 选项,编译器将按顺序处理文件列表,并重新编译每个出现的文件。 但是,如果指定了 /MP 选项,不同的编译器实例可能会同时编译相同的文件。 不同的实例可能会尝试同时写入相同的输出文件。 一个编译器将获得对输出文件独占写入访问权限并成功完成写入,而其他编译器实例则会失败并出现文件访问错误。

使用类型库 (#import)

编译器不支持通过 /MP 开关使用 #import 指令。 如果可能,请执行以下步骤解决此问题:

  • 将各种源文件中的所有 #import 指令移动到一个或多个文件,然后不使用 /MP 选项编译这些文件。 将生成一组头文件。

  • 在剩余的源文件中,插入指定生成标头的 #include 指令,然后使用 /MP 选项编译剩余源文件。

Visual Studio 项目设置

MSBuild 工具

Visual Studio 使用 MSBuild 工具 (msbuild.exe) 生成解决方案和项目。 MSBuild 工具的 /maxcpucount:number(或 /m:number)命令行选项可以同时生成多个项目。 /MP 编译器选项可以同时生成多个编译单元。 如果它适用于你的应用程序,可以使用 /MP 和/或 /maxcpucount 缩短解决方案生成时间。

解决方案生成时间在一定程度上取决于执行生成的进程数。 /maxcpucount MSBuild 选项的 number 参数指定同时生成的最大项目数。 类似地,/MP 编译器选项的 processMax 参数指定同时生成的最大编译单元数。 如果 /maxcpucount 选项指定了 P 项目,/MP 选项指定了 C 进程,P x C 个(最大数量)进程会同时执行。

决定使用 MSBuild 还是 /MP 技术的准则如下所示:

  • 如果有许多项目,而每个项目中只有少数几个文件,请使用带有 /maxcpucount 选项的 MSBuild 工具。

  • 如果项目较少,而每个项目中有许多文件,请使用 /MP 选项。

  • 如果项目数和每个项目中的文件数相当,请同时使用 MSBuild 和 /MP。 起初,将 /maxcpucount 选项设置为要生成的项目数,并将 /MP 选项设置为计算机上的处理器数。 测量性能,然后调整设置以生成最佳结果。 重复此过程,直到对总生成时间感到满意。

另请参阅

#import 指令
MSBuild 命令行参考
/Zf(更快的 PDB 生成)