.NET MAUI中API密钥的安全存储方案咨询：不提交Git但需编译入代码

针对你不想提交到Git但需要编译进代码的敏感信息需求，这里有几个实用方案，适配不同场景：

1. 使用.NET用户机密（User Secrets） #

这是.NET官方推荐的开发环境敏感信息存储方式，自动隔离Git提交：

• 右键MAUI项目 → 选择「管理用户机密」，会自动生成一个secrets.json文件（路径在用户目录，不在项目文件夹内），且项目的.gitignore会自动添加排除规则。
• 在secrets.json里配置密钥：

  {
    "ApiKeys": {
      "MyService": "your-sensitive-api-key-here"
    }
  }
  

• 代码中读取：利用.NET的配置系统，直接通过Configuration对象获取，比如在Program.cs里注入后使用：

  var apiKey = builder.Configuration["ApiKeys:MyService"];
  

2. 环境变量+配置绑定 #

适合多环境（开发/测试/生产）的场景，密钥存储在系统环境变量中：

• 设置环境变量：
  • Windows：右键「此电脑」→ 属性 → 高级系统设置 → 环境变量，添加名为MyApiKey的变量。
  • Mac/Linux：终端执行export MyApiKey="your-key"（临时生效，持久化需写入~/.bashrc或~/.zshrc）。
• 代码中读取：可以直接通过Environment.GetEnvironmentVariable获取，或者在配置中绑定：

  var apiKey = Environment.GetEnvironmentVariable("MyApiKey");
  // 或者通过配置系统加载
  builder.Configuration.AddEnvironmentVariables();
  var apiKeyFromConfig = builder.Configuration["MyApiKey"];
  

3. 自定义配置文件+Git排除 #

类似你之前Android Studio的secrets.xml方案，手动创建敏感配置文件并排除Git：

• 在项目根目录创建secrets.json（或其他格式，比如secrets.ini），写入密钥：

  {
    "ApiKey": "your-secret-key"
  }
  

• 编辑.gitignore，添加secrets.json（确保不会提交到仓库）。
• 在Program.cs中加载这个配置文件：

  builder.Configuration
    .AddJsonFile("secrets.json", optional: true, reloadOnChange: false);
  

• 代码中读取方式和用户机密一致。

4. 编译时条件常量（适合生产打包） #

如果是固定环境的密钥（比如生产环境），可以通过编译常量嵌入代码：

• 右键MAUI项目 → 属性 → 生成 → 在「条件编译符号」中添加（比如API_KEY="your-production-key"）。
• 代码中通过条件编译读取：

  #if API_KEY
  string apiKey = API_KEY;
  #endif
  

注意：这种方式会把密钥直接编译进程序集，反编译可能会暴露，建议配合代码混淆使用，且只用于非极端敏感的信息。

内容的提问来源于stack exchange，提问作者Cyriel Lamerigts