/Z7、/Zi、/ZI（调试信息格式）

痛定思痛。 2022-08-06 02:13 175阅读 0赞

选择为程序创建的调试信息的类型，并选择是将此信息保存在对象 (.obj) 文件还是程序数据库 (PDB) 中。

/Z{7|i|I}

![clear.gif][] 备注

下表描述了这些选项。

无

不产生任何调试信息，因此编译较快。

**/Z7**

生成包含用于调试器的完整符号调试信息的 .obj 文件。符号调试信息包括变量的名称和类型以及函数和行号。不会生成任何 .pdb 文件。

对于第三方库的发布者，不生成 .pdb 文件是一个优点。但是，在链接和调试期间，用于预编译头的 .obj 文件是必需的。如果 .pch 对象文件中只有类型信息（没有代码），则还必须使用 [/Yl（为调试库插入 PCH 引用）][Yl_ PCH] 进行编译。

**/Zi**

产生包含用于调试器的类型信息和符号调试信息的程序数据库 (PDB)。符号调试信息包括变量的名称和类型以及函数和行号。

**/Zi** 不影响优化。但是，**/Zi** 的确暗示了 **/debug**；有关更多信息，请参见 [/DEBUG（生成调试信息）][DEBUG]。

类型信息放置在 .pdb 文件而不是 .obj 文件中。

可以将 [/Gm（启用最小重新生成）][Gm] 和 **/Zi** 结合使用，但使用 **/Z7** 编译时不能使用 **/Gm**。

使用 **/Zi** 和 **/clr** 编译时，[DebuggableAttribute][] 属性将不会被放入程序集元数据中；如果要使用该属性，则必须在源代码中指定它。该属性可影响应用程序的运行时性能。有关 Debuggable 属性如何影响性能以及如何减轻性能影响的更多信息，请参见[令映像更易于调试][Link 1]。

**/ZI**

以支持“编辑并继续”功能的格式产生如上所述的程序数据库。如果想使用“编辑并继续”调试，则必须使用此选项。因为大多数优化与“编辑并继续”不兼容，所以使用 **/ZI** 会禁用代码中的所有 \#pragma optimize 语句。

**/ZI** 会导致在编译中使用 [/Gy（启用函数级链接）][Gy]。

**/ZI** 与 [/clr（公共语言运行库编译）][clr] 不兼容。

<table style="width: 100%;"> 
 <tbody> 
  <tr> 
   <th align="left"><img title="说明" src="http://i.msdn.microsoft.com/958x11bc.alert_note%28zh-cn,VS.90%29.gif" alt=""><strong>说明：</strong></th> 
  </tr> 
  <tr> 
   <td> <p><strong>/ZI</strong> 只可用于面向 x86 的编译器中；此编译器选项不可用于面向 x64 或 Itanium 处理器系列 (IPF) 的编译器中。</p> </td> 
  </tr> 
 </tbody> 
</table>

编译器将程序数据库命名为 项目.pdb。如果编译没有项目的文件，则编译器将创建名为 VCx0.pdb. 的数据库，其中 x 是正在使用的 Visual C++ 的主版本。编译器将 PDB 的名称嵌入每个使用此选项创建的 .obj 文件中，从而使调试器了解符号和行号信息的位置。当使用此选项时，.obj 文件将较小，因为调试信息存储在 .pdb 文件中而不是 .obj 文件中。

如果从使用此选项编译的对象创建库，则在将库链接到程序时，关联 .pdb 文件必须可用。因此，如果发布此库，就必须发布 PDB。

若要不使用 .pdb 文件创建包含调试信息的库，必须选择编译器的 C 7.0 兼容 (**/Z7**) 选项。如果使用预编译头选项，则预编译头和其他源代码的调试信息都放在 PDB 中。指定了“程序数据库”选项时将忽略 **/Yd** 选项。

### 在 Visual Studio 开发环境中设置此编译器选项 ###

1.  打开此项目的“属性页”对话框。有关详细信息，请参见[如何：打开项目属性页][Link 2]。
2.  单击“C/C++”文件夹。
3.  单击“常规”属性页。
4.  修改“调试信息格式”属性。

### 以编程方式设置此编译器选项 ###

*  请参见 [DebugInformationFormat][]。

[clear.gif]: http://i.msdn.microsoft.com/Global/Images/clear.gif
[Yl_ PCH]: http://msdn.microsoft.com/zh-cn/library/w6y1zk9f.aspx
[DEBUG]: http://msdn.microsoft.com/zh-cn/library/xe4t6fc1.aspx
[Gm]: http://msdn.microsoft.com/zh-cn/library/kfz8ad09.aspx
[DebuggableAttribute]: http://msdn.microsoft.com/zh-cn/library/system.diagnostics.debuggableattribute.aspx
[Link 1]: http://msdn.microsoft.com/zh-cn/library/9dd8z24x.aspx
[Gy]: http://msdn.microsoft.com/zh-cn/library/xsa71f43.aspx
[clr]: http://msdn.microsoft.com/zh-cn/library/k8d11d4s.aspx
[Link 2]: http://msdn.microsoft.com/zh-cn/library/e79xc5h1.aspx
[DebugInformationFormat]: http://msdn.microsoft.com/zh-cn/library/microsoft.visualstudio.vcprojectengine.vcclcompilertool.debuginformationformat.aspx