编译非托管代码时,可以通过设置 IDE 开关或命令线选项来配置可执行映像进行调试。 例如,可以使用 Visual C++ 中的 /Zi 命令行选项,使其发出调试符号文件(文件扩展名为 .pdb)。 同样,/Od 命令行选项告知编译器禁用优化。 生成的代码运行得更慢,但它是更轻松地调试,这很必要。
当编译.NET Framework 托管代码中,编译器如视觉对象C++,Visual Basic 和C#将它们的源程序编译为 Microsoft 中间语言 (MSIL)。 MSIL 然后进行 JIT 编译的之前执行,为本机代码。 与非托管代码一样,可以通过设置 IDE 开关或命令行选项来配置可执行映像进行调试。 此外可以配置用于大致相同的方式在调试 JIT 编译。
这种 JIT 配置具有两个方面:
-
可以请求 JIT 编译器以生成跟踪信息。 这使调试程序能将 MSIL 链与其机器码对应项相匹配,并跟踪存储本地变量和函数参数的位置。 从.NET Framework 2.0 版开始,JIT 编译器始终生成跟踪信息,因此无需进行请求它。
-
可以请求 JIT 编译器不优化生成的计算机代码。
通常情况下,生成 MSIL 的编译器设置这些 JIT 编译器选项,相应地基于 IDE 开关或命令行选项指定,例如,/Od。
某些情况下,可能需要更改 JIT 编译器的行为,使其生成的机器码更易于调试。 例如,可能希望为零售版本或控制优化生成实时跟踪信息。 可以使用初始化 (.ini) 文件来执行此操作。
例如,如果你想要调试该程序集名为MyApp.exe,则可以创建一个名为文本文件MyApp.ini,在相同的文件夹MyApp.exe,其中包含以下三行:
[.NET Framework Debugging Control]
GenerateTrackingInfo=1
AllowOptimize=0
可将每个选项的值设置为 0 或 1,任何不存在选项默认为 0。 将 GenerateTrackingInfo 设为 1、AllowOptimize 设为 0,这可提供最简单的调试。
从.NET Framework 2.0 版开始,JIT 编译器始终生成跟踪信息而不考虑为值GenerateTrackingInfo; 但是,AllowOptimize值仍产生影响。 如果使用 Ngen.exe(本机映像生成器)预编译本机映像而不进行优化,Ngen.exe 执行时 .ini 文件必须存在于 AllowOptimize=0 的目标文件夹。 如果已经预编译程序集而不进行优化,则必须删除预编译的代码使用 NGen.exe /uninstall选项才能重新运行 Ngen.exe 将代码预编译为优化。 如果.ini 文件不存在的文件夹中,默认情况下 Ngen.exe 将代码预编译为优化。
xref:System.Diagnostics.DebuggableAttribute?displayProperty=nameWithType 控制程序集的设置。 DebuggableAttribute是否 JIT 编译器应优化和/或生成跟踪信息包括两个字段的控件。 从.NET Framework 2.0 版开始,JIT 编译器始终生成跟踪信息。
对于零售版本中,编译器不设置任何DebuggableAttribute。 默认情况下,JIT 编译器生成最高的性能,最难调试的机器码。 启用实时跟踪会稍微降低性能,禁用优化会极大降低性能。
DebuggableAttribute 一次应用于整个程序集,而不是应用于程序集中的单个模块。 因此,开发工具必须将自定义属性附加到程序集元数据令牌,如果已经创建程序集,则附加到名为 System.Runtime.CompilerServices.AssemblyAttributesGoHere 的类。 然后,ALink 工具升级这些DebuggableAttribute它们的一部分可以从每个模块的程序集的属性。 如果没有冲突,ALink 操作失败。
Note: 在 .NET Framework 1.0 版本中,当指定 /clr 和 /Zi 编译器选项时,Microsoft Visual C++ 编译器将添加 DebuggableAttribute。 在.NET framework 版本 1.1 中,您必须添加DebuggableAttribute手动在代码或使用 /ASSEMBLYDEBUG链接器选项。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
