.NET 4.5.1 分离GitHub与本地开发环境配置方案

以下方案均满足复用同一套源文件、不改动现有含私有依赖的App.config/Settings.settings、公共仓库无额外维护成本的要求：

方案1：单文件隔离+.gitignore排除（推荐，改动量最小） #

• 新建专门存放敏感值的静态类Secrets.cs，所有GA ID、密钥等真实敏感值全部作为常量写在这个类里，代码中所有用到敏感值的地方统一引用这个类的常量。
• 将Secrets.cs加入.gitignore列表，永远不提交到公共仓库。
• 在仓库中提交同名功能的公开示例类Secrets.Public.cs，类名、命名空间、常量定义和私有版完全一致，所有敏感值替换为公开占位符（比如GA ID填"GA-DEMO-00000"，密钥填演示用假值），将这个文件的生成操作设为“编译”。
• 本地开发时，将私有版Secrets.cs的生成操作设为“编译”，公开版的生成操作设为“无”；公共仓库中因为不存在私有版文件，编译时自动使用公开版占位值，clone代码的用户可以直接编译运行，不会抛配置缺失错误。

方案2：MSBuild本地Props文件注入 #

• 项目根目录新建LocalSecrets.props文件，以MSBuild属性的形式写入所有真实敏感值，示例：

  <Project>
    <PropertyGroup>
      <GA_ID>UA-xxxxxx-x</GA_ID>
      <PrivateApiKey>your_real_private_key</PrivateApiKey>
    </PropertyGroup>
  </Project>
  

• 将LocalSecrets.props加入.gitignore，不提交到仓库。
• 在提交到仓库的.csproj文件末尾添加导入语句，增加存在性判断避免文件不存在时报错：

  <Import Project="LocalSecrets.props" Condition="Exists('LocalSecrets.props')" />
  

• 在项目中新增静态类读取编译时注入的属性值，没有本地props文件时自动使用公开占位值：

  internal static class BuildSecrets
  {
      // 未注入时自动使用公开占位值
      public const string GoogleAnalyticsId = "$(GA_ID)" == "" ? "GA-DEMO-00000" : "$(GA_ID)";
      public const string PrivateApiKey = "$(PrivateApiKey)" == "" ? "DEMO_PUBLIC_KEY" : "$(PrivateApiKey)";
  }
  

• 本地编译时MSBuild会自动读取本地props里的真实值注入到常量中，公共仓库编译时因为没有props文件，自动使用占位值，全程不需要修改原有配置文件。

方案3：用户环境变量读取 #

• 新增极简静态加载类，程序启动时优先读取当前Windows用户的环境变量，读取不到时自动 fallback 到公开占位值：

  internal static class SecretsLoader
  {
      public static readonly string GoogleAnalyticsId = 
          Environment.GetEnvironmentVariable("MYAPP_GA_ID", EnvironmentVariableTarget.User) 
          ?? "GA-DEMO-00000";
      
      public static readonly string PrivateApiKey = 
          Environment.GetEnvironmentVariable("MYAPP_API_KEY", EnvironmentVariableTarget.User) 
          ?? "DEMO_PUBLIC_KEY";
  }
  

• 本地开发时，只需要在Windows系统的当前用户环境变量中配置对应键的真实值即可，开发环境自动读取真实值。
• 公共仓库的用户没有配置对应环境变量，代码自动使用占位值，可直接编译运行，不需要额外配置，也不存在敏感值泄露风险。

注意：以上所有方案都不需要修改现有包含大量私有依赖的App.config、Settings.settings文件，原有配置逻辑可以完全保留，只需要把原来写死在代码/配置里的敏感值替换为对应静态类的属性/常量引用即可，单次配置完成后，后续提交代码不需要做任何敏感信息清理操作，公共仓库不需要维护独立分支或额外配置说明。

内容的提问来源于stack exchange，提问作者Arun Kumar