@debug 指令

项目
08/12/2011

开启或关闭调试符号的显示。

@set @debug(on | off)

实参

on
默认值。开启调试的关键字。
off
可选。关闭调试的关键字。

备注

JScript 作者编写的程序代码有时与所编译和运行的实际代码不同。宿主环境（如 ASP.NET）或开发工具可能会生成其自己的代码并将其添加到程序中。此代码在调试过程中通常对于作者不具有意义。因此，当调试代码时，代码作者通常只想看到程序中他们自己编写的部分，而不想包括由开发工具生成的部分。包作者可能会出于类似原因关闭调试。

只有在使用带有 /debug 选项的命令行编译时，或使用 @page 指令中设置的调试标志编译 ASP.NET 页时，编译器才发出调试符号。在这些情况下，debug 指令默认为打开。当 debug 指令出现时，它将一直有效，直至达到文件的末尾或找到下一个 debug 指令。

当 debug 指令关闭时，编译器不会为局部变量（在函数或方法中定义的变量）发出调试信息。但是，debug 指令不阻止为局部变量发出调试信息。

示例

从命令行使用 /debug 选项编译下面的代码时，这些代码会为局部变量 debugOnVar 但不为 debugOffVar 发出调试符号：

function debugDemo() {
   // Turn debugging information off for debugOffVar.
   @set @debug(off)
   var debugOffVar = 42;
   // Turn debugging information on.
   @set @debug(on)

   // debugOnVar has debugging information.
   var debugOnVar = 10;

   // Launch the debugger.
   debugger;
}

// Call the demo.
debugDemo();