-debug
选项将使编译器生成调试信息,并将此信息放置在输出文件或文件中。
语法
-debug[+ | -]
-debug:{full | pdbonly}
自变量
+ | -
指定 +
或仅 -debug
将导致编译器生成调试信息并将此信息放在程序数据库(.pdb
文件)中。 指定 -
(在不指定 -debug
时生效)将导致不创建任何调试信息。
full | pdbonly
指定编译器生成的调试信息的类型。 完整参数(在不指定 -debug:pdbonly
时生效)允许将调试器附加到正在运行的程序。 指定 pdbonly
允许在调试器中启动程序时进行源代码调试,但仅在正在运行的程序附加到调试器时才显示汇编程序。
备注
使用此选项创建调试版本。 如果未指定 -debug
、-debug+
或 -debug:full
,则无法调试程序的输出文件。
如果使用 -debug:full
,请注意,对经过优化的 JIT
代码的速度和大小会存在一定影响,且对包含 -debug:full
的代码质量也有一定影响。 建议使用 -debug:pdbonly
或不使用 PDB
生成发布代码。
备注
-debug:pdbonly
和-debug:full
之间的一个区别在于,使用-debug:full
,编译器将发出DebuggableAttribute
,用于告知 JIT 编译器有可用调试信息。 因此,在使用-debug:full
时,如果代码包含设置为false
的DebuggableAttribute
,则将出现错误。
有关如何配置应用程序的调试性能的详细信息,请参阅令映像更易于调试。
若要更改 .pdb
文件的位置,请参阅 -pdb
(C# 编译器选项)。
在 Visual Studio
开发环境中设置此编译器选项
- 打开项目的“属性”页。
- 单击“生成”属性页。
- 单击“高级”按钮。
- 修改“调试信息”属性。
有关如何以编程方式设置此编译器选项的信息,请参阅 DebugSymbols
。
示例
将调试信息放在输出文件 app.pdb
:
csc -debug -pdb:app.pdb test.cs