.NET项目如何配置本地开发版App.config文件？

针对你的需求，推荐以下几种纯文件级的实现方式，不用环境变量就能在开发调试时用本地敏感配置，同时不把敏感信息提交到版本控制系统：

方案1：用SlowCheetah做配置变换（适合多环境场景） #

这是.NET生态里常用的配置变换工具，能针对Debug/Release等环境自动替换配置项：

• 给项目安装SlowCheetah.XMLTransforms NuGet包
• 右键项目里的App.config，选择「Add Transform」，会自动生成App.Debug.config文件
• 在App.Debug.config里用变换语法替换敏感项，比如原App.config里有<add key="ApiKey" value="__PLACEHOLDER__" />，就在Debug变换文件里写：

<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <appSettings>
    <add key="ApiKey" value="你的真实API密钥" xdt:Transform="SetAttributes" xdt:Locator="Match(key)" />
  </appSettings>
</configuration>

• 把App.Debug.config加入.gitignore（或对应VCS的忽略规则），避免提交敏感信息
• 调试时，VS会自动用Debug变换文件生成带真实密钥的MyApp.dll.config

方案2：外部配置文件引用（最简单的轻量方案） #

把敏感配置单独抽成一个本地文件，让App.config直接引用它：

• 在原App.config的appSettings（或对应配置节）里添加file属性指向本地文件：

<appSettings file="Local.Settings.config">
  <!-- 这里放公共配置，比如非敏感的默认值 -->
  <add key="LogLevel" value="Debug" />
</appSettings>

• 创建Local.Settings.config文件，只放敏感配置：

<appSettings>
  <add key="ApiKey" value="你的真实API密钥" />
</appSettings>

• 把Local.Settings.config加入VCS忽略列表，确保不上传
• 调试时，.NET会自动合并原App.config和外部文件的配置，外部文件的配置优先级更高

方案3：预构建脚本替换占位符（灵活定制的方案） #

用脚本在构建前把本地敏感值替换到App.config的占位符里：

• 原App.config里留占位符：

<add key="ApiKey" value="[LOCAL_API_KEY]" />

• 创建本地文件LocalSecrets.txt，一行一个键值对：

ApiKey=你的真实API密钥
DbConnectionString=Server=localhost;Database=MyDb;...

• 编写PowerShell脚本ReplaceSecrets.ps1，读取LocalSecrets.txt并替换App.config里的占位符：

$secrets = Get-Content .\LocalSecrets.txt | ConvertFrom-StringData
$configPath = ".\App.config"
$configContent = Get-Content $configPath -Raw

foreach ($key in $secrets.Keys) {
    $placeholder = "[LOCAL_$key]"
    $configContent = $configContent -replace $placeholder, $secrets[$key]
}

Set-Content $configPath $configContent

• 右键项目→属性→生成事件→预构建事件命令行，添加：

powershell -ExecutionPolicy Bypass -File "$(ProjectDir)ReplaceSecrets.ps1"

• 把LocalSecrets.txt和ReplaceSecrets.ps1（如果不想提交脚本也可以忽略）加入VCS忽略
• 每次构建前，脚本会自动把敏感值替换到App.config里，生成正确的MyApp.dll.config

注意事项 #

• 不管用哪种方案，一定要确保包含敏感信息的本地文件被添加到VCS的忽略规则里，比如Git的.gitignore要加对应的文件名
• 如果是团队协作，建议把示例配置（比如Local.Settings.config.example）提交到VCS，让其他开发者知道需要创建哪些本地配置项

内容的提问来源于stack exchange，提问作者Rui Oliveira