如何在ASP.NET Core中通过C#代码手动设置IHostingEnvironment为开发环境

我想通过C#代码手动把IHostingEnvironment实例设置为开发环境，不想用命令行方式。目前我的Startup类代码片段如下：

public Startup(IHostingEnvironment env)
{
    var builder = new ConfigurationBuilder();
    if (env.IsDevelopment()) {

解决方案 #

有两种常见的实现方式，你可以根据场景需求选择：

1. 在主机构建阶段指定（官方推荐）

官方建议在应用启动的主机构建环节就确定环境，这样整个应用生命周期内的环境配置都是统一的。在Program.cs的主机构建代码里，直接用UseEnvironment方法指定即可：

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                // 手动指定为开发环境
                webBuilder.UseEnvironment(EnvironmentName.Development);
                webBuilder.UseStartup<Startup>();
            });
}

注：如果是ASP.NET Core 2.x版本，代码会略有不同——使用WebHost.CreateDefaultBuilder而非Host.CreateDefaultBuilder，但UseEnvironment方法的用法完全一致。

2. 在Startup内部临时修改（不推荐，但可实现）

如果你确实需要在Startup类内部调整环境，可以直接设置IHostingEnvironment（ASP.NET Core 3.0+推荐用IWebHostEnvironment）的EnvironmentName属性：

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;

public Startup(IHostingEnvironment env)
{
    // 手动将环境设置为开发环境
    env.EnvironmentName = EnvironmentName.Development;

    var builder = new ConfigurationBuilder();
    if (env.IsDevelopment()) {
        // 此时就能进入开发环境的分支逻辑
        builder.AddUserSecrets<Startup>();
    }
    // 后续配置代码...
}

注意事项 #

• EnvironmentName是Microsoft.Extensions.Hosting命名空间下的常量，预定义了Development、Staging、Production三个常用环境值，你也可以自定义环境名称。
• ASP.NET Core 3.0及以上版本中，IHostingEnvironment已被标记为过时，建议使用IWebHostEnvironment接口，两者的属性和方法完全一致。
• 尽量避免在Startup内部修改环境——环境配置属于应用启动阶段的全局设置，中途修改可能导致配置加载逻辑混乱。

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