更新:2007 年 11 月

/debug 选项使编译器生成调试信息并将其放置在一个或多个输出文件中。

/debug[+ | <U>-</U>]
/debug:{<U>full</U> | pdbonly}

参数

+ | -

指定 + 或只指定 /debug 将使编译器生成调试信息,并将这些信息放置在一个程序数据库(.pdb 文件)中。指定 -(在不指定 /debug 时有效)将导致不创建任何调试信息。

full | pdbonly

指定编译器生成的调试信息类型。full 参数在没有指定 /debug:pdbonly 时有效,它允许将调试器附加到正在运行的程序。指定 pdbonly 允许在调试器中启动程序时进行源代码调试,但仅在正在运行的程序附加到调试器时才显示汇编程序。

备注

使用该选项创建调试版本。如果未指定 /debug/debug+/debug:full,则无法调试程序的输出文件。

如果使用 /debug:full,请注意 /debug:full 可能会对 JIT 优化代码的速度和大小有一些影响,并且可能会稍微影响代码质量。我们建议在生成发布代码时使用 /debug:pdbonly 或不使用 PDB。

说明:

/debug:pdbonly/debug:full 的一个区别是:使用 /debug:full 时,编译器会发出 DebuggableAttribute,用于通知 JIT 编译器有可用的调试信息。因此,如果使用 /debug:full,而代码中包含设置为 false 的 DebuggableAttribute,则会发生错误。

有关如何配置应用程序的调试性能的信息,请参见使映像更易于调试

若要更改 .pdb 文件的位置,请参见 /pdb(指定调试符号文件)(C# 编译器选项)

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

  1. 打开项目的“属性”页。

  2. 单击“生成”属性页。

  3. 单击“高级”按钮。

  4. 修改“调试信息”属性。

有关如何以编程方式设置此编译器选项的信息,请参见 DebugSymbols

示例

将调试信息放置在输出文件 app.pdb 中:

 复制代码
csc /debug /out:app.pdb test.cs

请参见

其他资源

项目属性 (Visual Studio)