MSYS2中GCC设置rpath编译正常，运行时找不到动态库的原因

核心原因 #

编译时-L ./lib是告诉链接器去./lib目录查找库文件，所以链接阶段能顺利完成；但Windows（包括MSYS2环境下的PE格式程序）的DLL加载逻辑不识别Linux风格的-rpath参数，运行时系统加载器会遵循自身的搜索顺序查找DLL，默认不会主动去./lib目录定位文件。

Windows DLL加载的默认搜索优先级：

• 执行程序所在的目录
• 系统目录（如C:\Windows\System32）
• PATH环境变量中列出的目录

解决办法 #

1. 直接复制DLL到程序目录 #

把lib/libtest.dll复制到a.exe所在的工作目录，这是测试场景下最直接的方案。

2. 将lib目录加入PATH环境变量 #

临时生效（仅当前终端会话）：

export PATH="$PATH:$(pwd)/lib"

永久生效（MSYS2环境）：
编辑~/.bashrc或~/.zshrc，加入上述命令，保存后重启终端即可。

3. 使用$ORIGIN指定相对程序目录的路径 #

在编译命令中用$ORIGIN表示程序自身所在目录，让加载器从程序目录下的lib子文件夹查找DLL：

gcc main.c -ltest -L ./lib -Wl,-rpath='$ORIGIN/lib'

注意：$ORIGIN需要用单引号包裹，避免被Shell解析成变量。该方式在MSYS2终端运行或直接双击exe时均能生效。

4. 静态链接（需库支持） #

如果libtest.dll有对应的静态库文件（如libtest.a），可以采用静态链接编译，彻底摆脱对DLL文件的依赖：

gcc main.c -static -ltest -L ./lib

内容的提问来源于stack exchange，提问作者jiangyin first brother