原始碼使用 /// 三斜線註釋,加入 /doc 選項編譯即自動產生 XML 文件檔。
// my.cs
using System;
/// 範例類別,含文件註釋
public class MyDocument {
/// 程式進入點
public static void Main(string[] argv) {
Console.WriteLine("A Sample Class");
}
}
csc /doc:my.xml my.cs
產生的 my.xml 結構化保存所有 /// 註釋,可供 IntelliSense、文件產生器(如 Sandcastle、DocFX)使用。
預設錯誤僅顯示檔名。加入 /fullpaths 後,錯誤/警告訊息包含完整絕對路徑,利於大型專案或自動化建置腳本定位問題。
csc /fullpaths my.cs
啟用增量編譯器,僅重新編譯自上次建置後異動的方法。搭配 /debug 時,偵錯資訊存 .pdb,編譯狀態存 .incr(檔名:輸出檔名.incr)。
csc /incremental /out:my.exe my.cs
成功產生 my.exe 與 my.exe.incr。適合大型專案開發期頻繁建置,顯著縮短編譯時間。
在輸出組件中建立資源檔連結而非內嵌,利於多專案共享同一資源(圖片、音訊等),避免重複副本。
/linkresource:filename,identifier,mimetype
filename:資源檔路徑identifier(選填):邏輯名稱,預設為檔名mimetype(選填):MIME 類型字串csc /linkres:reso.resource myResource.cs