.NET6 F#项目嵌入资源路径与AssemblyName不匹配问题求解

核心原因 #

F#项目的嵌入资源默认命名规则和C#项目存在差异：

• C#项目默认以<AssemblyName>或显式配置的<RootNamespace>作为嵌入资源的命名前缀
• F#项目默认以项目文件的文件名（去掉.fsproj后缀）作为嵌入资源的根前缀，和配置的AssemblyName、解决方案显示名、项目所在文件夹名、DefaultNamespace配置均无关联。你的项目文件名为Core.UnitTests.fsproj，因此aaa.txt的资源名自动生成为Core.UnitTests.aaa.txt，这是F# SDK的默认设计行为，不是配置错误。

另外F#项目中的<DefaultNamespace>节点本身就不会对嵌入资源命名产生作用，这也是你之前修改该配置没有效果的原因。

推荐解决方案 #

按优先级从高到低可选以下方案：

方案1：显式指定资源逻辑名（最稳定） #

直接在项目文件中为嵌入资源配置固定的LogicalName，彻底绕开默认命名规则，后续修改项目名、程序集名都不会影响资源读取：

<ItemGroup>
  <EmbeddedResource Include="aaa.txt" LogicalName="UnitTests.Core.aaa.txt" />
</ItemGroup>

配置后你最初用assembly.GetName().Name拼接资源路径的代码可以正常运行，不需要额外的运行时反射逻辑。

方案2：修改项目配置统一资源前缀 #

如果项目中嵌入资源较多，不想逐个配置LogicalName，可以在fsproj的PropertyGroup节点中关闭默认的文件依赖命名约定，同时指定RootNamespace，让资源前缀和程序集名保持一致：

<PropertyGroup>
  <TargetFramework>net6</TargetFramework>
  <AssemblyName>UnitTests.Core</AssemblyName>
  <RootNamespace>UnitTests.Core</RootNamespace>
  <EmbeddedResourceUseDependentUponConvention>false</EmbeddedResourceUseDependentUponConvention>
</PropertyGroup>

配置后aaa.txt的资源名会自动生成为UnitTests.Core.aaa.txt，和程序集名称匹配。

方案3：运行时动态匹配资源（无项目配置改动） #

如果不想修改项目文件配置，不要使用取第一个导出类型命名空间的临时方案（当程序集无公开导出类型时会抛出异常），可以直接遍历程序集的所有资源名，按文件名后缀匹配目标资源：

let getEmbeddedResource (assembly: Assembly) (fileName: string) =
    assembly.GetManifestResourceNames()
    |> Seq.tryFind (fun resName -> resName.EndsWith($".{fileName}"))
    |> Option.bind (fun resName ->
        let stream = assembly.GetManifestResourceStream(resName)
        if stream = null then None else Some stream)

// 调用示例
let assembly = Assembly.GetExecutingAssembly()
use aaaStream = getEmbeddedResource assembly "aaa.txt" |> Option.defaultWith (fun () -> failwith "嵌入资源aaa.txt未找到")

该方案容错性最高，不受项目配置、命名规则变动的影响。

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