如何拒绝ASP.NET默认配置文件，改用自定义单一配置文件？

ASP.NET默认会自动加载launchSettings.json、appSettings.json等配置文件，但完全可以替换为自定义配置文件，具体步骤如下：

1. 清除默认配置源 #

默认的WebApplication.CreateBuilder(args)会自动添加一系列配置源（包括appSettings、环境变量、命令行参数、launchSettings等）。要停用这些默认配置，先清空配置集合：

var builder = WebApplication.CreateBuilder(args);
// 清空所有默认配置源
builder.Configuration.Sources.Clear();

2. 添加自定义配置文件 #

接下来添加你的自定义配置文件（比如myconfig.json）：

// 添加基础自定义JSON配置，设置为必填文件
builder.Configuration.AddJsonFile("myconfig.json", optional: false, reloadOnChange: true);
// 可选：添加对应环境的自定义配置（比如开发环境的myconfig.Development.json）
builder.Configuration.AddJsonFile($"myconfig.{builder.Environment.EnvironmentName}.json", optional: true, reloadOnChange: true);

• optional: false：表示配置文件必须存在，否则项目启动报错
• reloadOnChange: true：配置文件修改后自动重载，无需重启项目

3. 处理launchSettings.json #

launchSettings.json仅用于开发环境的启动配置（比如端口、环境变量），要停用它直接删除该文件即可。之后可以通过命令行参数指定启动参数，例如：

dotnet run --urls=http://localhost:5000 --environment=Development

4. 验证配置生效 #

可以在代码中读取自定义配置项测试：

var app = builder.Build();

// 读取自定义配置中的某个键值
var myCustomSetting = app.Configuration["MyCustomKey"];
app.MapGet("/", () => $"自定义配置值：{myCustomSetting}");

app.Run();

可选：保留部分默认配置源 #

如果不需要完全清空所有默认配置，只想移除特定源（比如appSettings），可以针对性删除：

// 找到并移除appSettings相关的配置源
var appSettingsSource = builder.Configuration.Sources
    .FirstOrDefault(s => s is JsonConfigurationSource json && json.Path.StartsWith("appSettings"));
if (appSettingsSource != null)
{
    builder.Configuration.Sources.Remove(appSettingsSource);
}

注意 #

自定义配置文件需设置正确的复制属性：右键文件→属性→复制到输出目录，选择“如果较新则复制”或“始终复制”，确保运行时能读取到文件。

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