C#项目单配置文件下不同环境连接字符串显隐控制问题咨询

你原有方案失效的核心原因：C# 中的#if、#else等预处理指令是编译时特性，仅作用于.cs等C#源码文件，对appsettings.json、web.config这类静态配置文件不会生效，直接在配置文件里加预处理指令无法被识别处理。
下面是适配不同场景的可行方案：

方案1：使用原生配置变换功能（适合编译时按环境打包的场景） #

属于.NET生态原生支持的功能，无需额外引入组件：

• 首先在项目中定义两种编译配置，比如Debug（对应需要显示连接串的环境）和Production（对应需要隐藏连接串的环境），在Production配置的属性中添加自定义编译常量HIDE_CONNECTION_STRING
• 如果你使用的是SDK风格的.NET Core/.NET 5+项目，直接在.csproj项目文件中添加条件编译逻辑，自动替换配置文件内容：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <!-- 其他项目配置 -->
  <ItemGroup Condition="'$(Configuration)' == 'Production'">
    <Content Update="appsettings.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <!-- 正则匹配连接字符串行，替换为隐藏值 -->
      <ReplacePatterns>
        <ReplacePattern Pattern="(&quot;DefaultConnection&quot;:)\s*&quot;[^&quot;]*&quot;" Replacement="$1 &quot;***连接串已隐藏***&quot;" />
      </ReplacePatterns>
    </Content>
  </ItemGroup>
</Project>

• 如果你使用的是.NET Framework的传统项目，直接使用内置的Web.config变换功能，新增Web.Production.config变换文件，写入如下内容即可在打生产包时自动替换连接串：

<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <connectionStrings xdt:Transform="Replace">
    <add name="DefaultConnection" connectionString="***连接串已隐藏***" providerName="System.Data.SqlClient" />
  </connectionStrings>
</configuration>

方案2：使用T4模板生成配置文件（适合严格要求单源配置文件的场景） #

如果你必须只能维护单个配置源文件，可以用T4模板实现编译时动态生成配置文件：

1. 将原有的appsettings.json重命名为appsettings.tt，写入如下模板内容：

<#@ template debug="false" hostspecific="true" language="C#" #>
<#@ assembly name="System.Core" #>
<#
// 读取当前编译配置的预处理常量
bool isHideEnv = false;
#if HIDE_CONNECTION_STRING
isHideEnv = true;
#endif
#>
{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "ConnectionStrings": {
<# if (isHideEnv) { #>
    "DefaultConnection": "***连接串已隐藏***"
<# } else { #>
    "DefaultConnection": "Server=127.0.0.1;Database=MyDb;Uid=root;Pwd=123456;"
<# } #>
  }
}

2. 保存模板后会自动生成对应的appsettings.json文件，每次切换编译配置时重新生成模板即可得到对应环境的配置内容，全程只需要维护appsettings.tt这一个源文件即可。

方案3：运行时动态覆盖（适合同一套编译产物适配多环境的场景） #

如果你的需求是同一套发布包要在不同环境运行，编译时无法确定目标环境，可以在程序启动时读取当前环境标识，动态覆盖配置中的连接字符串：

var builder = WebApplication.CreateBuilder(args);
// 读取系统环境变量判断当前运行环境
if (Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") == "Production")
{
    // 覆盖内存中的配置值，不会修改物理配置文件
    builder.Configuration["ConnectionStrings:DefaultConnection"] = "***连接串已隐藏***";
}
// 后续其他服务注册逻辑

注意事项 #

• 如果是生产环境要保护敏感信息，更推荐使用ASP.NET Core密钥管理器、云厂商密钥管理服务等方案存储连接串，不要将明文敏感信息写入配置文件
• 预处理指令仅在编译阶段生效，如果需要运行时动态调整，优先选择方案3实现

内容的提问来源于stack exchange，提问作者Esmaeil Chitgar