Windows11下Code::Blocks编译C++无法找到-lSDL2_image与-lSDL2_ttf

1. 确认库与MinGW的架构匹配 #

Code::Blocks自带的MinGW默认是32位（i686），你下载的SDL_image和SDL_ttf必须和这个位数完全一致：

• 如果MinGW是32位，下载i686版本的库；如果是64位，下载x86_64版本。
• 架构不匹配会直接导致ld跳过库，出现「不兼容被跳过」的提示。

2. 检查库文件的命名与存在性 #

ld查找库时会自动添加lib前缀和.a/.dll.a后缀，所以你放到C:\Program Files\CodeBlocks\MinGW\lib里的文件必须是：

• libSDL2_image.a（静态库）或libSDL2_image.dll.a（动态库导入库）
• libSDL2_ttf.a（静态库）或libSDL2_ttf.dll.a（动态库导入库）
  确认文件名无拼写错误，比如不要写成SDL2_image.lib（这是MSVC格式的库，MinGW不识别）。

3. 手动配置Code::Blocks项目的链接器设置 #

即使你把库放到了MinGW的默认路径，项目可能没继承全局配置，需要手动设置：

• 右键项目 → Build options
• 切换到Linker settings标签：
  • 点击Add，直接选择C:\Program Files\CodeBlocks\MinGW\lib下的libSDL2_image.a和libSDL2_ttf.a；或者在输入框中填写SDL2_image、SDL2_ttf（Code::Blocks会自动补全前缀后缀）。
  • 在Other linker options里可以直接添加：-lSDL2_image -lSDL2_ttf
• 切换到Search directories → Linker标签：
  • 确认已添加C:\Program Files\CodeBlocks\MinGW\lib的路径，若没有则点击Add手动添加。

4. 处理SDL_ttf的依赖项 #

SDL_ttf依赖FreeType库，若你下载的SDL_ttf包未包含对应的MinGW版本FreeType，需要：

• 下载与MinGW架构匹配的FreeType库，将其libfreetype.a/libfreetype.dll.a放到C:\Program Files\CodeBlocks\MinGW\lib。
• 在项目链接器设置中添加freetype库（步骤同3）。

5. 验证动态库的运行时路径 #

编译完成后，需要将SDL_image、SDL_ttf及其依赖的DLL文件（如SDL2_image.dll、SDL2_ttf.dll、libfreetype-6.dll等）放到以下任一位置：

• 项目编译生成的EXE文件同目录
• C:\Windows\System32（64位系统放64位DLL）
• C:\Windows\SysWOW64（64位系统放32位DLL）

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