如何在Cabal项目中便捷链接子目录下的SO/DLL库？

一、正确配置.cabal文件中的相对路径 #

你之前在cabal.project里设置extra-lib-dirs没生效，核心原因是cabal.project的相对路径是基于你运行cabal命令的工作目录，而非项目根。更可靠的方式是直接在项目的.cabal文件中配置：

-- 在你的包的library/executable代码块下添加
extra-lib-dirs: clib/my
extra-libraries: Something

这里的clib/my是相对于.cabal文件所在目录（即项目根）的路径，只要开发者在项目根目录运行cabal命令，路径就能正确解析。

二、跨平台适配库命名差异 #

不同系统的动态库命名规则有区别，用Cabal的条件编译可以完美适配：

library
  -- 其他配置项...
  extra-lib-dirs: clib/my
  if os(linux) || os(darwin)
    -- Linux自动匹配libSomething.so，Mac自动匹配libSomething.dylib
    extra-libraries: Something
  if os(windows)
    -- Windows自动匹配Something.dll
    extra-libraries: Something

如果你的库命名有特殊差异（比如Windows端叫SomethingX.dll），直接在对应系统的条件块里修改extra-libraries的值即可。

三、用脚本统一设置环境变量（备选方案） #

如果上面的配置仍有问题，可以给不同系统编写简单的启动脚本，自动配置动态库搜索路径：

• Linux/Mac：在项目根创建build.sh

  #!/bin/bash
  export LIBRARY_PATH="./clib/my:$LIBRARY_PATH"
  cabal build
  

• Windows：创建build.bat

  set LIB=.\clib\my;%LIB%
  cabal build
  

开发者只需运行对应脚本，就能自动将项目子目录加入动态库搜索路径，无需手动设置环境变量。

四、避坑注意事项 #

• 确保clib/my下的库文件名符合系统规范：Linux为lib<name>.so，Mac为lib<name>.dylib，Windows为<name>.dll，Cabal才能正确识别。
• 全程使用基于项目根的相对路径，绝不写死绝对路径，保证Git共享后适配不同开发者的文件布局。
• 尽量升级到Cabal 3.0+版本，新版本对extra-lib-dirs的相对路径解析逻辑更稳定。

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