@debug 指示詞

發行項
08/21/2008

更新：2007 年 11 月

開啟或關閉發出偵錯符號。

@set @debug(on | off)

引數

on
預設值。開啟偵錯的關鍵字。
off
選擇項。關閉偵錯的關鍵字。

備註

JScript 作者撰寫的程式碼有時會與實際編譯和執行的程式碼不同。主機環境 (例如 ASP.NET) 或開發工具可能會產生自己的程式碼，並將這些程式碼加入程式中。在偵錯階段作者通常對這些程式碼不感興趣。因此，在為自己的程式碼進行偵錯時，程式碼作者通常只想要看到他們所撰寫的程式部分，而不是開發工具所產生的部分。套件 (Package) 作者可能會因為相同原因關閉偵錯。

只有在命令列上使用 /debug 選項進行編譯，或使用 @page 指示詞中所設定的偵錯旗標編譯 ASP.NET 網頁，編譯器才會發出偵錯符號。在這些情況下，debug 指示詞的預設值為 on。當 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();