ASP.NET Core Web应用开发环境多appsettings配置问题咨询

你遇到的_content/...静态资源加载失败，和多配置文件加载逻辑无关，核心原因是ASP.NET Core对开发环境的判断是精确匹配规则：只有当ASPNETCORE_ENVIRONMENT的值完全等于Development时，框架才会启用开发环境专属逻辑，包括Blazor/RCL类库静态资源的开发时路径映射、热重载、开发异常页等功能。
你把环境值设为Development.Linux后，框架会将其识别为自定义非开发环境，不会启用开发时静态资源映射——这类_content路径下的资源在开发阶段不会物理拷贝到项目wwwroot目录，只有发布时才会输出，自然会报找不到路径的错误。

你完全可以在程序启动阶段通过代码手动指定环境，不需要绑定ASPNETCORE_ENVIRONMENT的固定值，同时自定义多配置文件的加载规则，以.NET 6+的Program.cs为例：

// 读取当前传入的环境变量
var runtimeEnv = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT");
var builder = WebApplication.CreateBuilder(new WebApplicationOptions
{
    // 只要环境变量前缀匹配Development，就强制标记为开发环境
    EnvironmentName = runtimeEnv?.StartsWith("Development") == true 
        ? Microsoft.Extensions.Hosting.Environments.Development 
        : runtimeEnv
});

// 自定义配置文件加载顺序
// 1. 先加载通用开发环境配置
builder.Configuration.AddJsonFile(
    "appsettings.Development.json", 
    optional: true, 
    reloadOnChange: true);
// 2. 根据当前运行平台加载专属配置，后加载的配置会覆盖同名配置项
if (OperatingSystem.IsLinux())
{
    builder.Configuration.AddJsonFile(
        "appsettings.Development.Linux.json", 
        optional: true, 
        reloadOnChange: true);
}
if (OperatingSystem.IsWindows())
{
    builder.Configuration.AddJsonFile(
        "appsettings.Development.Windows.json", 
        optional: true, 
        reloadOnChange: true);
}

// 后续服务注册、中间件配置逻辑保持原有写法即可
// ...
var app = builder.Build();
// ...
app.Run();

用这段代码后，即使你把ASPNETCORE_ENVIRONMENT设为Development.Linux，框架依然会识别为开发环境，静态资源映射、热重载等功能全部正常，同时会按顺序加载通用配置+平台专属配置。

不建议把平台标识拼接在ASPNETCORE_ENVIRONMENT值中，这会破坏框架内置的环境判断逻辑。更合理的做法是：

• 所有开发场景下的启动配置，统一将ASPNETCORE_ENVIRONMENT设为Development，保证框架开发环境逻辑正常运行
• 新增自定义环境变量标识运行平台，比如在launchSettings.json中加APP_RUNTIME_PLATFORM变量，Windows启动项设为Windows，WSL启动项设为Linux
• 启动时读取这个自定义变量，加载对应平台的配置文件即可

调整后的launchSettings核心配置示例：

"profiles": {
    "Kestrel Dev Blazor (Windows)": {
        "commandName": "Project",
        "environmentVariables": {
            "ASPNETCORE_ENVIRONMENT": "Development",
            "APP_RUNTIME_PLATFORM": "Windows"
        }
        // 其余端口、启动路径等配置保持不变
    },
    "Kestrel Dev Blazor (WSL2)": {
        "commandName": "WSL",
        "environmentVariables": {
            "ASPNETCORE_ENVIRONMENT": "Development",
            "APP_RUNTIME_PLATFORM": "Linux",
            // 其余LD_LIBRARY_PATH等Linux专属配置不变
        }
        // 其余发行版、端口等配置保持不变
    }
}

对应的配置加载代码只需要把判断操作系统的逻辑，换成读取APP_RUNTIME_PLATFORM变量即可，这种实现完全符合ASP.NET Core的配置设计规范，不会出现意料之外的环境兼容问题。

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