/Zm（指定预编译标头的内存分配限额）

  • 项目

确定编译器分配的用于构造预编译标头的内存量。

语法

/Zmfactor

参数

factor
一个比例因子百分数，确定编译器用于构造预编译标头的内存量。

factor 自变量是编译器定义的工作缓冲区的默认大小所占的百分比。 factor 的默认值是 100 (%)，但你可以指定更大或更小的数值。

注解

Visual Studio 2015 之前的版本中，C++ 编译器使用几个离散堆，每个堆都有一定的限制。 当前，编译器可根据需要动态增加堆，最多可增加到总堆大小限制，并允许预编译标头构成多个地址范围。 现在，很少需要 /Zm 编译器选项。

如果在你使用 /Zm 编译器选项时，编译器用完堆空间，并发出 C1060 错误消息，则你可能保留了太多的内存。 可考虑移除 /Zm 选项。

如果编译器发出 C1076 错误消息，则伴随的 C3859 消息会指定你在使用 /Zm 编译器选项重新编译时要使用的 factor 自变量。 仅当预编译标头使用 #pragma hdrstop 时，此消息才重要。 在其他情况下，这是 Windows 虚拟内存压力问题导致的虚假错误，应忽略使用 /Zm 选项的建议。 相反，请考虑在使用 MSBUILD.EXE 的 /maxcpucount 选项以及 CL.EXE 的 /MP 选项时减少并行进程的数量。 有关详细信息，请参阅预编译标头 (PCH) 问题和建议。

下表显示了 factor 参数对内存分配限制的影响。 此表中，我们假定默认预编译标头缓冲区的大小为 75 MB。

factor 的值 内存分配限制
10 7.5 MB
100 75 MB
200 150 MB
1000 750 MB
2000 1500 MB

设置内存分配限制的其他方式

在 Visual Studio 开发环境中设置 /Zm 编译器选项

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

  2. 选择“配置属性”>“C/C++”>“命令行”属性页。

  3. 在“附加选项”框中输入 /Zm 编译器选项。

以编程方式设置 /Zm 编译器选项

另请参阅

MSVC 编译器选项
MSVC 编译器命令行语法