Windows下GCC链接raylib静态库失败问题求助

问题 #

Windows环境下，使用FASM将汇编文件编译为COFF格式.obj文件，目标调用raylib库的DrawCircle()函数，静态库libraylib.a与汇编文件在同一目录：

1. 执行fasm main.asm成功生成.obj文件
2. 执行gcc main.obj -o main -l libraylib.a，报错：

C:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: cannot find -llibraylib.a: No such file or directory

3. 尝试gcc main.obj -o main libraylib.a，出现大量未定义引用错误：

C:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: libraylib.a(rcore.o):rcore.c:(.text+0x1bc4f): undefined reference to `timeEndPeriod'
C:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: libraylib.a(rcore.o):rcore.c:(.text+0x20748): undefined reference to `timeBeginPeriod'
C:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: libraylib.a(rglfw.o):rglfw.c:(.text+0x3186): undefined reference to `__imp_CreateRectRgn'
C:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: libraylib.a(rglfw.o):rglfw.c:(.text+0x31c2): undefined reference to `__imp_DeleteObject'
C:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: libraylib.a(rglfw.o):rglfw.c:(.text+0x32b1): undefined reference to `__imp_SwapBuffers'
...（省略其余重复报错）
collect2.exe: error: ld returned 1 exit status

解决方案 #

错误原因分析 #

1. 第一个报错：-l参数使用格式错误。-l后应直接跟库名（需去掉lib前缀和.a后缀），且若库在当前目录，需用-L.指定库搜索路径。
2. 第二个报错：raylib静态库依赖Windows系统的多个底层库，链接时未引入这些依赖库，导致函数引用无法解析。

正确链接命令 #

使用以下两种方式之一即可：

方式1：通过-l参数指定库

gcc main.obj -o main -L. -lraylib -lwinmm -lgdi32 -luser32

方式2：直接指定静态库文件

gcc main.obj -o main libraylib.a -lwinmm -lgdi32 -luser32

参数说明 #

• -L.：告知gcc在当前目录搜索静态库文件
• -lraylib：链接raylib静态库（对应libraylib.a）
• -lwinmm：解决timeBeginPeriod/timeEndPeriod等多媒体定时器函数的引用问题
• -lgdi32：解决CreateRectRgn/SwapBuffers等GDI图形接口函数的引用问题
• -luser32：补充用户界面相关的系统函数依赖

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