如何强制.NET NuGet优先加载runtimes目录中的本地共享库

你遇到的问题是Linux下系统自带的libSDL2.so会被优先加载，而非NuGet包中包含的版本。这是因为Linux动态链接器默认会先搜索系统标准库路径（比如/usr/lib），再考虑进程的工作目录或自定义路径。下面是几个可行的解决办法，按推荐程度排序：

方法1：手动指定库路径并通过NativeLibrary加载（最可靠） #

通过手动加载NuGet包中的本地库，完全绕过系统的默认搜索逻辑。这样后续的DllImport会优先使用你已加载的库实例。

实现步骤： #

1. 在你的F#代码中添加初始化逻辑，确保调用任何SDL2方法前执行：

open System
open System.IO
open System.Runtime.InteropServices
open System.Runtime.InteropServices.RuntimeInformation

module SdlLoader =
    let private loadSdlLibrary () =
        // 拼接NuGet包中native库的输出路径
        let runtimeDir = Path.Combine(AppContext.BaseDirectory, "runtimes", "linux-x64", "native")
        let libPath = Path.Combine(runtimeDir, "libSDL2.so")

        if File.Exists(libPath) then
            try
                // 手动加载包内的库
                NativeLibrary.Load(libPath) |> ignore
                printfn $"Successfully loaded SDL2 from package: {libPath}"
            with ex ->
                failwith $"Failed to load packaged SDL2: {ex.Message}"
        else
            // 可选： fallback到系统库
            NativeLibrary.Load("libSDL2.so") |> ignore
            printfn "Falling back to system SDL2 library"

    // 模块初始化时自动执行加载逻辑
    do loadSdlLibrary ()

2. 保持你的DllImport特性不变：

[<DllImport("libSDL2.so", CallingConvention = CallingConvention.Cdecl)>]
extern int SDL_Init(uint32 flags)

手动加载库后，CLR会优先使用这个已加载的实例，不会再去搜索系统路径。

方法2：修改DllImport的库路径为相对路径 #

通过在DllImport中指定相对路径，引导CLR优先查找输出目录下的库。结合条件编译适配多平台：

#if LINUX
let libName = @"runtimes/linux-x64/native/libSDL2.so"
#elif OSX
let libName = @"runtimes/osx-x64/native/libSDL2.dylib"
#elif WINDOWS
let libName = @"runtimes/win-x64/native/SDL2.dll"
#else
let libName = "libSDL2.so" // 兜底选项
#endif

[<DllImport(libName, CallingConvention = CallingConvention.Cdecl)>]
extern int SDL_Init(uint32 flags)

你的fsproj已经设置了<CopyToOutputDirectory>Always</CopyToOutputDirectory>，所以native文件会被正确复制到输出目录的对应路径，这个方法可以直接生效。

方法3：通过NuGet targets文件设置LD_LIBRARY_PATH #

你可以在NuGet包中添加.targets文件，自动为引用该包的项目修改Linux下的库搜索路径，让输出目录的native文件夹优先被搜索。

实现步骤： #

1. 在项目中创建build文件夹，添加MyPackage.targets文件：

<Project>
  <PropertyGroup>
    <!-- Linux下将native目录加入LD_LIBRARY_PATH最前端 -->
    <LD_LIBRARY_PATH Condition="'$(OS)' == 'Linux'">$(OutputPath)runtimes/linux-x64/native:$(LD_LIBRARY_PATH)</LD_LIBRARY_PATH>
  </PropertyGroup>
  <!-- 将环境变量传递给运行时进程 -->
  <ItemGroup>
    <EnvironmentVariable Include="LD_LIBRARY_PATH" Value="$(LD_LIBRARY_PATH)" Condition="'$(OS)' == 'Linux'" />
  </ItemGroup>
</Project>

2. 修改fsproj，将这个targets文件包含到NuGet包：

<ItemGroup>
  <Content Include="build/MyPackage.targets">
    <PackagePath>build/</PackagePath>
    <Pack>true</Pack>
  </Content>
  <!-- 保留你原有的native文件配置 -->
  <Content Include="lib/*.so" >
    <PackagePath>runtimes/linux-x64/native/%(Filename)%(Extension)</PackagePath>
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    <Pack>true</Pack>
  </Content>
</ItemGroup>

这样其他项目引用你的NuGet包时，LD_LIBRARY_PATH会被自动修改，动态链接器会先搜索包内的native目录。

验证方法 #

不管用哪种方法，都可以通过LD_DEBUG=libs dotnet fsi someScript.fsx命令验证，输出中应该会显示加载的是NuGet包中的libSDL2.so路径，而非系统路径。

内容的提问来源于stack exchange，提问作者Mads Obitsø Thomsen