含原生库的.NET类库：项目引用时消费项目deps.json未填充原生库路径，NuGet引用正常的配置方案咨询

我刚好遇到过几乎一模一样的问题！核心原因是项目引用（ProjectReference）和NuGet包引用的构建逻辑差异：NuGet打包时会自动处理原生库的runtime路径映射并写入deps.json，但项目引用默认不会触发这套流程。不过我们可以通过调整类库的.csproj配置来让两种引用方式表现一致。

具体解决方案 #

在你的类库项目（也就是DQD.ForkPTY）的.csproj文件中添加以下配置：

<PropertyGroup>
  <!-- 强制生成runtime配置文件，确保项目引用时也能写入deps.json -->
  <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>
</PropertyGroup>

<ItemGroup>
  <!-- 规范声明原生库文件，让MSBuild在项目引用时识别并处理路径 -->
  <NativeFileReference Include="runtimes/$(RuntimeIdentifier)/native/libDQD.ForkPTY.Native.Linux.so">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <Pack>true</Pack>
    <PackagePath>runtimes/$(RuntimeIdentifier)/native/</PackagePath>
  </NativeFileReference>
</ItemGroup>

为什么这能生效？ #

• GenerateRuntimeConfigurationFiles：这个属性会强制项目在构建时生成包含runtime依赖信息的配置文件，而这一步在项目引用场景下默认是关闭的，只有NuGet包引用会自动触发。
• NativeFileReference：这是MSBuild专门用来声明原生库的项类型，比普通的Content或None更精准。它会告诉构建系统这个文件是原生库，需要在项目引用时将其路径信息注入到消费项目的deps.json中，同时也不影响NuGet打包的逻辑。

验证步骤 #

1. 清理并重新构建整个解决方案
2. 打开消费项目（DQD.ForkPTY.Playground）的bin/Debug/netX/linux-x64/DQD.ForkPTY.Playground.deps.json文件，你应该能看到类似这样的条目：

   "runtimeTargets": {
     "runtimes/linux-x64/native/libDQD.ForkPTY.Native.Linux.so": {
       "assetType": "native",
       "rid": "linux-x64"
     }
   }
   

3. 运行消费项目，此时CLR会根据deps.json的指引去正确的runtime目录加载原生库，不会再出现找不到文件的崩溃。

额外注意事项 #

• 如果你的类库要支持多个RID，把NativeFileReference的Include改成通配符（比如runtimes/*/native/*.so）即可，但要注意过滤掉不需要的文件。
• 确保消费项目的RuntimeIdentifier设置正确（比如linux-x64），或者在构建时通过dotnet build -r linux-x64指定RID，这样MSBuild才能匹配到对应的原生库路径。

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