为何调用Winmm.lib的简单C++音频代码无法链接？

问题重现 #

环境 #

• Windows 10 64位系统
• G++（MinGW64）编译器

测试代码 #

#include<Windows.h>

int main()
{
    mciSendString("open \"Test.mp3\" type mpegvideo alias mp3", NULL, 0, NULL);
    mciSendString("play mp3", NULL, 0, NULL);
}

编译命令 #

g++ -lWinmm main.cpp

错误输出 #

C:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: C:\Users\myName\AppData\Local\Temp\ccic5o7r.o:Main.cpp:(.text+0x2b): undefined reference to `__imp_mciSendStringA'
C:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: C:\Users\myName\AppData\Local\Temp\ccic5o7r.o:Main.cpp:(.text+0x4f): undefined reference to `__imp_mciSendStringA'
collect2.exe: error: ld returned 1 exit status

错误原因分析 #

1. 链接器参数顺序错误：GNU链接器按从左到右的顺序解析符号依赖。如果先指定-lwinmm，链接器处理库时还没有源文件的未定义符号，会直接跳过库中的符号；后续处理main.cpp生成的未定义符号时，已无对应库可查找，导致报错。
2. 库文件格式不兼容：你尝试使用的C:\Program Files (x86)\Windows Kits\10\Lib\...\WinMM.Lib是MSVC编译器的库文件格式，MinGW链接器无法直接识别。MinGW有自己的配套库，位于其安装目录的lib文件夹下（如mingw64\x86_64-w64-mingw32\lib\libwinmm.a）。
3. 字符集宏的混淆：mciSendString是宏定义，默认会根据UNICODE宏展开为mciSendStringW（宽字符版本），但编译时可能因环境变量或编译参数影响，实际生成了对mciSendStringA的引用，但本质问题还是链接阶段的库查找失败。

解决方案 #

1. 调整编译命令的参数顺序 #

将库链接参数放到源文件之后，让链接器先处理源文件的符号引用，再从库中查找实现：

g++ main.cpp -lwinmm

2. 无需指定Windows Kits的库路径 #

MinGW的链接器会自动搜索其自带的库目录，不需要通过-L指定Windows Kits的路径，直接使用上述命令即可链接到正确的libwinmm.a库。

3. （可选）明确指定字符集版本 #

避免宏展开的混淆，可显式指定使用的字符集版本：

• 若使用ANSI版本（对应mciSendStringA）：

#define UNICODE 0
#define _UNICODE 0
#include<Windows.h>

int main()
{
    mciSendStringA("open \"Test.mp3\" type mpegvideo alias mp3", NULL, 0, NULL);
    mciSendStringA("play mp3", NULL, 0, NULL);
}

• 若使用Unicode版本（对应mciSendStringW）：

#define UNICODE
#define _UNICODE
#include<Windows.h>

int main()
{
    mciSendStringW(L"open \"Test.mp3\" type mpegvideo alias mp3", NULL, 0, NULL);
    mciSendStringW(L"play mp3", NULL, 0, NULL);
}

4. 运行验证 #

编译成功后，确保Test.mp3位于生成的可执行文件同一目录，或使用绝对路径指定文件位置，即可正常播放音频。

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