C# 編譯器回應檔 (.rsp) 完整指南：簡化命令列建置流程

什麼是回應檔？

回應檔（Response File，慣用 .rsp 副檔名）是純文字檔，儲存 csc.exe 編譯選項。編譯時以 @檔名.rsp 指定，編譯器會讀取檔案內容作為命令列參數。解決「參數過長、易打錯、難維護」三大痛點。

基本語法與範例

建立 MyLib.rsp

# MyLib.rsp - 編譯選項回應檔
# 輸出目標與名稱
/t:library
/out:MyLib.dll

# 遞迴包含所有 .cs 檔
/recurse:*.cs

# 產生 XML 文件
/doc:MyLib.xml

# 強名簽署
/keyfile:Keys\MyKey.snk

# 定義條件編譯符號
/define:DEBUG;TRACE

# 警告等級
/warn:4
/nowarn:1591

編譯指令

csc @MyLib.rsp

多重回應檔組合

csc @Common.rsp @Debug.rsp @Sign.rsp

按遇到順序處理，後設定會覆蓋先設定。常見模式：

• Common.rsp：共用設定（目標框架、警告等級、輸出路徑）
• Debug.rsp / Release.rsp：建置配置專用（/define、/optimize）
• Sign.rsp：簽署相關（/keyfile、/delaysign）

預設回應檔：csc.rsp

• 位於 csc.exe 同目錄（通常在 %FrameworkDir%）
• 每次編譯自動載入，內含常用組件參考（System.dll、System.Xml.dll、System.Windows.Forms.dll 等）
• 查看內容：type %FrameworkDir%\csc.rsp

停用預設回應檔

csc /noconfig @MyLib.rsp

適用於：需完全控制參考組件、避免隱性相依、跨框架建置等情境。

進階技巧

MSBuild / dotnet CLI 整合

雖 dotnet build 以 MSBuild 為主，但可透過 <CscAdditionalArguments>@Custom.rsp</CscAdditionalArguments> 於 .csproj 注入自訂編譯參數。

最佳實務清單

1. 將專案通用編譯選項集中至 Common.rsp，納入版控
2. 建置腳本（.cmd/.ps1）僅呼叫 csc @Common.rsp @Config.rsp
3. 避免在回應檔寫死絕對路徑，改用相對路徑或環境變數
4. 定期檢視 csc.rsp 確認隱性參考無衝突
5. 文件化每個 .rsp 檔用途，降低團隊認知負擔

結語

回應檔是 C# 命令列建置的「組態即代碼」利器。善用它可消除冗長命令列、統一團隊建置標準、支援多環境配置切換。即使現代專案多用 MSBuild/dotnet CLI，理解 csc.rsp 機制仍有助於排查建置異常與客製化編譯流程。