Show/Hide Toolbars

XSharp

 

使用 -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 时将代码中的 DebuggableAttribute 设置为 false,就会出现错误。

 

 

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

 

要更改 .pdb 文件的位置,请参阅 -pdb

 

要在 Visual Studio 开发环境中设置该编译器选项,请执行以下操作

 

1.打开项目的 "属性"页面.

2.点击 Build 选项卡

3.编辑 Debug Info 属性.

4.查看属性页

 

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

示例

 

将调试信息放入输出文件 app.pdb:

 

 

xsc -debug -pdb:app.pdb test.prg