如何在NuGet包中读取已包含的HTML内容文件

你遇到的问题核心在于contentFiles目录的文件是被部署到引用项目中，而非嵌入到NuGet的程序集里，所以直接通过程序集路径去查找自然找不到。下面给你两种可行的解决方案，优先推荐嵌入资源的方式，更可靠：

方案一：将HTML文件作为嵌入资源（推荐） #

这种方式会把HTML文件直接打包进NuGet的DLL中，读取时不需要依赖外部文件，不会出现丢失的情况。

步骤1：配置NuGet项目中的HTML文件属性 #

在你的NuGet项目里，右键点击Inlined.html文件，选择「属性」：

• 将「生成操作」设置为嵌入的资源（Embedded Resource）
• 确保「复制到输出目录」设置为不复制（因为文件已经嵌入到DLL里了）

对应的csproj配置会自动变成：

<ItemGroup>
  <EmbeddedResource Include="Inlined.html" />
</ItemGroup>

如果文件在子文件夹里（比如Resources/Inlined.html），Include路径要对应调整，最终嵌入的资源名称会是「命名空间.子文件夹.文件名」。

步骤2：编写读取代码 #

要读取嵌入的资源，需要通过程序集的GetManifestResourceStream方法。注意资源名称的格式是项目命名空间+文件路径（用点分隔），比如你的项目命名空间是Ssff，文件在根目录，资源名就是Ssff.Inlined.html。

示例代码：

using System.IO;
using System.Reflection;

public static string GetHtmlContentFromNuGet()
{
    // 获取包含嵌入资源的程序集（用NuGet项目中的任意类来定位，避免硬编码程序集名）
    var assembly = Assembly.GetAssembly(typeof(你的NuGet类名));
    // 替换成实际的资源名称，不确定的话可以用下面的代码列出所有资源
    string resourceName = "Ssff.Inlined.html";

    // 可选：列出所有嵌入资源，方便排查资源名称是否正确
    // foreach (var name in assembly.GetManifestResourceNames())
    // {
    //     Console.WriteLine(name);
    // }

    using (var stream = assembly.GetManifestResourceStream(resourceName))
    {
        if (stream == null)
            throw new FileNotFoundException("未找到嵌入的HTML资源，请检查资源名称是否正确", resourceName);
        
        using (var reader = new StreamReader(stream))
        {
            return reader.ReadToEnd();
        }
    }
}

方案二：继续使用contentFiles，确保文件复制到输出目录 #

如果你坚持用contentFiles，需要确保文件被复制到引用项目的输出目录，这样才能通过文件系统读取。

步骤1：修改NuGet项目的csproj配置 #

在你的NuGet项目的csproj里，添加对contentFiles的复制配置：

<ItemGroup>
  <Content Include="contentFiles\Inlined.html">
    <!-- 确保文件复制到引用项目的输出目录 -->
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <!-- 指定NuGet包中的路径 -->
    <PackagePath>contentFiles\any\any\Inlined.html</PackagePath>
    <IncludeInPackage>true</IncludeInPackage>
  </Content>
</ItemGroup>

步骤2：调整读取代码 #

此时文件会被复制到引用项目的输出目录（和exe/dll同目录），所以读取路径应该用应用程序的基目录：

var htmlPath = Path.Combine(AppContext.BaseDirectory, "Inlined.html");
string htmlContent = File.ReadAllText(htmlPath);

为什么你的原有代码失效？ #

你之前的代码试图从程序集所在目录的contentFiles文件夹找文件，但contentFiles的文件默认不会被放在NuGet程序集的目录下，而是会被部署到引用项目的内容目录中（如果没有配置CopyToOutputDirectory，甚至不会出现在输出目录）。所以直接通过程序集路径查找自然找不到。

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