使用Chipmunk Physics Library编译时遇链接器错误求助

1. 核对编译架构一致性 #

• 确认编译Chipmunk2D使用的MinGW架构（32位i686/64位x86_64）与当前编译项目的MinGW完全匹配。若Chipmunk是64位编译产物，而你用32位MinGW编译项目，必然触发链接错误。
• 可通过执行gcc -v查看当前编译器架构，同时核对Chipmunk编译时的CMake配置参数（比如是否指定了-DCMAKE_C_COMPILER=i686-w64-mingw32-gcc或x86_64版本的编译器）。

2. 验证导入库的正确性 #

• MinGW调用DLL需要对应导入库（通常命名为libchipmunk.dll.a，而非静态库libchipmunk.a）。你当前用-lchipmunk链接时，可能误指向了静态库而非DLL导入库。
• 检查build/src目录是否存在libchipmunk.dll.a：
  • 若存在，确保链接器优先识别该文件；
  • 若不存在，需重新配置CMake编译Chipmunk：添加-DBUILD_SHARED_LIBS=ON参数，强制生成DLL及对应导入库，再重新编译项目。

3. 检查函数符号修饰规则 #

• MinGW与MSVC的函数符号修饰规则不兼容，若编译Chipmunk时使用了MSVC工具链，生成的DLL函数符号无法被MinGW识别。
• 执行nm -D libchipmunk.dll查看DLL导出的函数名，对比报错的cpBodySetVelocity是否完全一致（注意是否有下划线前缀等差异）。若符号不匹配，需改用MinGW工具链重新编译Chipmunk。

4. 调整链接库的顺序 #

• MinGW链接器对库的顺序敏感，依赖库需放在被依赖的目标文件之后。将-lchipmunk移至编译命令的末尾：

  gcc my_sources.c 
  -IC:/SDL/SDL2-2.26.4/i686-w64-mingw32/include/SDL2 
  -IC:/path/to/Chipmunk2D-master/include/chipmunk 
  -LC:/SDL/SDL2-2.26.4/i686-w64-mingw32/lib 
  -LC:/path/to/Chipmunk2D-master/build/src 
  -o MyProject
  -lmingw32 -lSDL2main -lSDL2 -lchipmunk
  

5. 确认头文件宏定义正确 #

• Chipmunk2D的头文件中存在控制函数导出/导入的宏（如CP_EXPORT），使用DLL时需确保项目编译时未定义CP_BUILDING_SHARED——该宏是编译Chipmunk库时用于标记导出函数的，若在你的项目中误定义，编译器会尝试导出而非导入函数，引发链接错误。
• 可打开chipmunk.h查看相关宏定义：

  #ifdef CP_BUILDING_SHARED
  #define CP_EXPORT __declspec(dllexport)
  #else
  #define CP_EXPORT __declspec(dllimport)
  #endif
  

  确保你的项目编译参数中无-DCP_BUILDING_SHARED。

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