多環境 web.config 管理最佳實踐：configSource 拆分與外部化配置策略

專案隨著規模增長，單一 web.config 會變得龐大且難以維護；多環境 (Dev/Test/Staging/Prod) 參數差異導致配置漂移。.NET 2.0+ 提供 configSource 屬性，支援將配置區段外部化為獨立檔案，實現「化整為零、環境隔離、安全管控」。

核心機制：configSource

<!-- Web.config -->
<system.web>
  <profile configSource="profile.config" />
</system.web>

<!-- profile.config -->
<profile>
  <properties>
    <add name="Name" type="String" />
    <add name="Age" type="Int32" />
  </properties>
</profile>

執行時自動合併，對應用程式透明。

拆分原則與限制

• **僅限配置區段** (ConfigurationSection)，不可拆分區段群組 (ConfigurationSectionGroup) 或元素 (Element)。
• 常見拆分對象：<connectionStrings>、<appSettings>、<system.web/membership>、<system.web/roleManager>、<system.serviceModel> 等。

多環境策略

1. 基礎配置：共用邏輯放主 web.config。
2. 環境差異：連線字串、服務端點、功能開關等放外部檔 (如 connectionStrings.Dev.config、connectionStrings.Prod.config)。
3. 部署時替換：CI/CD 階段依環境複製對應檔案為正式檔名 (如 connectionStrings.config)，或使用 配置轉換 (Web.config.transform)。

安全與運維建議

• 外部配置檔**副檔名用 .config** (IIS 預設拒絕直接下載)，勿用 .xml/.txt。
• 敏感值 (密碼、金鑰) 應加密儲存 (aspnet_regiis -pef) 或存放於 Key Vault / 環境變數，不入版控。
• 需修改外部配置後自動回收應用程式池，可設定 restartOnExternalChanges="true" (參閱 MSDN)。

遷移至 ASP.NET Core

Core 採用 appsettings.json + 環境變數 + 命令列參數 + 使用者密鑰 等多層疊加配置系統，理念一致但實作不同，建議重新規劃而非直接移植。