.NET Core类库（打包NuGet）使用JSON配置替代.config的问题解决

阿华AIGC实验室

2026-5-21

当然可以在.NET Core类库中用appsettings.json替代.config文件，只是类库不像Web项目那样会自动帮你加载配置文件，得自己处理加载逻辑——这也是你遇到“文件不存在”报错的核心原因。下面给你几种靠谱的解决方案，按需选择：

方案一：依赖宿主项目的配置系统（最推荐）

这种方式完全贴合.NET Core的依赖注入设计原则，类库不用自己操心配置加载的事儿，把配置的控制权交给引用你的宿主项目（比如ASP.NET Core Web应用、控制台应用）。

步骤：

在类库的服务类中，通过构造函数接收IConfiguration参数：

using Microsoft.Extensions.Configuration;

public class YourLibraryService
{
    private readonly IConfiguration _config;

    // 让DI容器自动注入IConfiguration
    public YourLibraryService(IConfiguration config)
    {
        _config = config;
    }

    public string GetYourSetting()
    {
        // 直接读取配置，比如读取"YourLibrary:ApiKey"节点
        return _config["YourLibrary:ApiKey"];
    }
}

宿主项目（比如Web项目）本来就默认加载了appsettings.json，你只需要在宿主的appsettings.json里添加类库需要的配置节点，然后把你的类库服务注册到DI容器：

// 在Program.cs中
builder.Services.AddScoped<YourLibraryService>();

这样宿主启动时，会自动把加载好的配置注入到你的类库服务中，完全不用管文件路径的问题。

方案二：类库自带appsettings.json，作为内容文件随NuGet发布

如果你希望类库自带默认配置，不需要宿主额外配置，可以把json文件打包到NuGet里，让它自动复制到宿主的输出目录。

步骤：

先处理类库项目的文件属性：
- 右键类库中的appsettings.json → 属性 → 设置“复制到输出目录”为「如果较新则复制」或「始终复制」。
- 或者直接在.csproj里添加配置（更可靠）：
```
<ItemGroup>
  <Content Include="appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <PackageCopyToOutput>true</PackageCopyToOutput>
  </Content>
</ItemGroup>
```
这样打包NuGet时，这个文件会被包含，引用该NuGet的项目会自动把它复制到输出目录。
在类库中手动加载配置：

using Microsoft.Extensions.Configuration;
using System.IO;

public class YourLibraryService
{
    private readonly IConfiguration _config;

    public YourLibraryService()
    {
        var builder = new ConfigurationBuilder()
            // 设置基础路径为宿主程序的工作目录（一般就是输出目录）
            .SetBasePath(Directory.GetCurrentDirectory())
            // 加载appsettings.json，optional设为false表示文件必须存在
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);

        _config = builder.Build();
    }

    public string GetYourSetting()
    {
        return _config["YourSettingKey"];
    }
}

注意：如果宿主程序的工作目录不是输出目录，可能会找不到文件，不过绝大多数Web/控制台项目的工作目录都是输出目录，所以这个问题很少出现。

方案三：将appsettings.json嵌入到类库程序集（最可靠，无外部文件依赖）

如果不想依赖外部文件，怕用户引用NuGet后弄丢配置文件，可以把json文件直接嵌入到类库的dll里，从程序集资源中读取。

步骤：

在类库的.csproj里设置文件为嵌入资源：

<ItemGroup>
  <EmbeddedResource Include="appsettings.json">
    <LogicalName>appsettings.json</LogicalName>
  </EmbeddedResource>
</ItemGroup>

在类库中从嵌入资源加载配置：

using Microsoft.Extensions.Configuration;
using System.IO;
using System.Reflection;

public class YourLibraryService
{
    private readonly IConfiguration _config;

    public YourLibraryService()
    {
        var assembly = Assembly.GetExecutingAssembly();
        // 注意：这里的资源名称是「类库命名空间+文件名」，比如你的类库命名空间是"MyCompany.MyLibrary"，那就是"MyCompany.MyLibrary.appsettings.json"
        var resourceName = "YourLibraryNamespace.appsettings.json";
        
        using var stream = assembly.GetManifestResourceStream(resourceName);
        if (stream == null)
        {
            throw new FileNotFoundException("嵌入的appsettings.json资源不存在，请检查资源名称是否正确。");
        }

        var builder = new ConfigurationBuilder()
            .AddJsonStream(stream);

        _config = builder.Build();
    }

    public string GetYourSetting()
    {
        return _config["YourSettingKey"];
    }
}

不确定资源名称的话，可以用assembly.GetManifestResourceNames()打印所有嵌入资源的名称，找到对应的那个。

解决你遇到的「文件不存在」报错

你之前的报错大概率是以下原因之一：