Delphi IDE 命令列參數完整參考：啟動選項、除錯參數與專案載入控制

前言

Delphi IDE (Delphi32.exe / BDS.exe) 支援豐富的命令列參數，可自動化啟動行為、載入特定專案、啟用除錯模式、控制視覺效果等。本文整理官方文件與實務常用參數，供建置腳本、CI/CD 整合、快速啟動捷徑參考。

參數語法規則

• 不區分大小寫：-ns = /NS = -Ns
• 參數與值以空格分隔：-d MyProject.exe
• 路徑含空格需雙引號：-sd "C:\My Projects\Source"

常用啟動控制參數

除錯相關參數

除錯參數組合範例

# 載入專案進行除錯，指定原始碼路徑，傳遞參數給被除錯程式
BDS.exe -D "C:\Projects\MyApp\Win32\Debug\MyApp.exe" -SD "C:\Projects\MyApp\Source" -TD "/config test.ini"

# 遠端除錯
BDS.exe -D "C:\Remote\MyApp.exe" -H "192.168.1.100" -TD "/server 192.168.1.1"

專案載入與建置參數

建置自動化範例

# 批次建置並輸出錯誤記錄
BDS.exe -B -O "C:\BuildLogs\BuildErr.txt" "C:\Projects\MyProject.dproj"

# 僅語法檢查
BDS.exe -M "C:\Projects\MyProject.dproj"

實務應用場景

1. 建立快速啟動捷徑

目標: "C:\Program Files\Embarcadero\Studio\22.0\bin\BDS.exe" -NS -NP
起始位置: "C:\MyProjects"

2. CI/CD 自動化建置腳本

@echo off
set BDS="C:\Program Files\Embarcadero\Studio\22.0\bin\BDS.exe"
%BDS% -B -O "Build_%DATE:~-4,4%%DATE:~-10,2%%DATE:~-7,2%.log" "MyProject.dproj"
if errorlevel 1 (
  echo Build Failed!
  exit /b 1
)

3. 即時除錯註冊

系統註冊表 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AeDebug 設定 Debugger 值：

"C:\Program Files\Embarcadero\Studio\22.0\bin\BDS.exe" -ATTACH:%ld;%ld

版本差異提醒

• Delphi 7 及之前：執行檔為 Delphi32.exe
• Delphi 8 及之後 (BDS 系列)：執行檔為 BDS.exe (含 Delphi、C++Builder、RAD Studio)
• 參數語法高度相容，但新版支援更多 MSBuild 整合參數

結語

善用 Delphi IDE 命令列參數，能將「手動點點點」轉化為「可重現、可自動化」的工程流程。建議團隊建立標準啟動捷徑、建置腳本模板，並納入版本控管，確保開發環境一致性。