开发环境如何在环境变量存储密钥且避免提交至Git？

这个问题在日常开发中太常见了，我整理了几个简单易操作、还能保证开发/生产环境代码一致的方案，帮你解决痛点：

一、先明确：VS的.vs目录绝对不能提交到Git！ #

你猜的没错，VS调试面板里设置的环境变量确实存在.vs目录下，但这个目录是本地IDE生成的专属配置文件夹，包含了你的个人调试设置、项目缓存、甚至敏感的本地配置信息，每个人的.vs内容都不一样，提交到Git只会导致团队成员之间的配置冲突，还可能泄露敏感密钥。

一定要把.vs添加到你的.gitignore文件里，确保它永远不会被提交：

.vs/

二、通用密钥加载方案：让开发/生产代码完全一致 #

核心思路是：统一通过环境变量读取密钥，开发环境用本地配置文件注入变量，生产环境直接用服务器/云平台的环境变量，代码逻辑完全不用改，操作也很简单：

1. 用.env文件管理开发环境密钥 #

这是目前最流行的轻量方案，步骤超简单：

• 在项目根目录新建一个.env文件，用键值对的方式写你的开发密钥：

  API_KEY=your_test_api_key_123
  DB_PASSWORD=dev_db_pass_456
  

• 把.env加入.gitignore，避免提交：

  .env
  

• 根据你的编程语言，安装一个轻量的环境变量加载库（比如.NET用DotNetEnv，Python用python-dotenv，Node.js用dotenv），在项目启动时自动加载.env里的变量到系统环境变量中。
• 代码里统一通过环境变量获取密钥，举几个例子：
  .NET：

  var apiKey = Environment.GetEnvironmentVariable("API_KEY") ?? throw new Exception("API_KEY环境变量未设置");
  

  Node.js：

  const apiKey = process.env.API_KEY;
  if (!apiKey) throw new Error('API_KEY环境变量未配置');
  

  这样一来，开发环境启动时会自动加载.env的变量，生产环境直接读取服务器上配置的环境变量，代码完全一致，不用做任何分支判断。

2. VS调试环境变量的补充用法（可选） #

如果你习惯用VS的「属性→调试→环境变量」来设置，那也没问题——因为这些配置存在.vs里，而我们已经把.vs加入.gitignore了，不会被提交。不过相比.env，这种方式只能在VS里生效，换用其他IDE（比如Rider、VS Code）的同事就没法直接复用你的配置，所以更推荐用.env的跨IDE方案。

三、额外的安全小提醒 #

• 绝对不要在代码里硬编码密钥，哪怕是注释里也不行，防止不小心提交到Git。
• 可以创建一个.env.example文件，只写密钥的键名（值留空或写占位符），提交到Git，方便团队成员知道需要配置哪些环境变量：

  API_KEY=（请填写测试环境API密钥）
  DB_PASSWORD=（请填写测试数据库密码）
  

• 开发环境的密钥尽量用测试专用的，不要和生产环境的密钥共用，降低泄露风险。

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