ASP.NET Core通过ASPNETCORE_ENVIRONMENT变量管理多环境配置,支持Development、Staging、Production三种默认环境,该变量决定加载对应appsettings.{Environment}.json文件;可在操作系统、launchSettings.json、Docker/K8s、Web服务器中设置;自定义环境变量可通过IConfiguration读取,且优先级高于配置文件;结合appsettings.json分层管理配置,敏感信息推荐由环境变量注入;在Program.cs或Startup.cs中使用IWebHostEnvironment的IsDevelopment()等方法判断当前环境并启用相应中间件,实现灵活安全的配置管理。

ASP.NET Core 提供了灵活的方式来管理不同运行环境下的配置,环境变量是其中关键的一环。应用通过环境变量 ASPNETCORE_ENVIRONMENT 来识别当前运行环境,常见的值有 Development、Staging 和 Production。
设置 ASPNETCORE_ENVIRONMENT 变量
这个变量决定了应用加载哪个环境特定的配置文件,比如 appsettings.Development.json 或 appsettings.Production.json。你可以在多个地方设置它:
- 操作系统环境变量:直接在系统中设置,适用于全局生效。
- launchSettings.json:开发阶段最常用的方式,在项目目录的 Properties 文件夹中配置,只影响本地调试。
- Docker 或 K8s 配置:容器化部署时通过 Dockerfile 或 yaml 文件注入。
- Web 服务器配置:如 IIS 的 web.config 或 Nginx 的启动脚本中设置。
读取自定义环境变量
除了框架级别的环境标识,你还可以在代码中读取自定义环境变量,用于数据库连接、密钥等配置:
IConfiguration configuration = new ConfigurationBuilder()
.AddEnvironmentVariables()
.Build();
string myVar = configuration["MY_CUSTOM_VAR"];
如果使用默认的主机构建方式(如 CreateDefaultBuilder),环境变量源已经自动添加,可直接通过 IConfiguration 实例访问。
结合 appsettings.json 使用
推荐将配置分层管理:
PHP商城系统是国内领先商城系统,网店系统,购物系统,网上商城系统,B2C商城系统产品.同时也是一个商业的PHP开发框架。PHP 商城系统由内容、文章、会员、留言、订单、 财务、广告、短消息、数据库管理、营销推广、内置支付管理、商品配送管理、无限级分类、全站搜索等多个功能模块插件组成。在当今瞬机万变的市场环境中,快速高效的IT解决方案是您业务成功的关键。我们PHP商城系统能为您量身打造完全符合需求
- appsettings.json:存放通用配置。
- appsettings.{Environment}.json:覆盖特定环境的值。
- 环境变量:用于敏感信息或部署时动态传入,优先级最高。
例如,数据库连接字符串在开发环境用本地地址,生产环境通过环境变量提供,避免硬编码。
判断当前环境并执行逻辑
在 Startup.cs 或 Program.cs 中,可以通过 IWebHostEnvironment 判断环境:
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
else
{
app.UseExceptionHandler("/Error");
}
支持的方法有 IsDevelopment()、IsStaging()、IsProduction(),便于控制中间件行为。
基本上就这些。合理利用环境变量,能让应用在不同阶段安全、灵活地运行。









