Windows下使用SDL2编译出现undefined reference错误求助

问题分析 #

你遇到的undefined reference错误核心原因有两个：

1. vcpkg与MinGW库冲突：编译输出中出现vcpkg的x64-windows路径，这是MSVC版本的库，和MinGW的目标文件格式不兼容，导致链接器无法找到SDL函数的实现。
2. CMake链接配置冗余且逻辑错误：重复添加SDL2main、-lSDL2等库，且在定义SDL_MAIN_HANDLED的情况下不需要链接SDL2main（该库用于将WinMain入口转成自定义main函数，而SDL_MAIN_HANDLED会告诉SDL直接使用你编写的main函数）。

解决方案 #

1. 禁用vcpkg对当前项目的干扰 #

在CMakeLists.txt开头添加代码，避免vcpkg的MSVC版本SDL2被错误引入：

# 覆盖vcpkg工具链，强制使用系统MinGW库
set(CMAKE_TOOLCHAIN_FILE "" CACHE STRING "" FORCE)

2. 修正CMakeLists.txt配置 #

简化链接库配置，去掉冗余项，确保只链接必要的库：

cmake_minimum_required(VERSION 3.25)
project(client C)

set(CMAKE_C_STANDARD 23)

# 禁用vcpkg工具链
set(CMAKE_TOOLCHAIN_FILE "" CACHE STRING "" FORCE)

# 查找MinGW版本的SDL2
find_package(SDL2 REQUIRED)
include_directories(${SDL2_INCLUDE_DIRS})

# 整理源文件，去掉重复的头文件引用
set(SOURCES 
    src/main.c 
    src/client.c 
    include/client.h
)
add_executable(Client ${SOURCES})

# 仅链接SDL2和ws2_32（因定义了SDL_MAIN_HANDLED，无需SDL2main）
target_link_libraries(Client PRIVATE ${SDL2_LIBRARIES} ws2_32)

3. 验证SDL2库与MinGW位数匹配 #

确保复制到MinGW目录的SDL2库是对应位数的MinGW版本：

• 64位MinGW对应x86_64-w64-mingw32版本的SDL2库
• 32位MinGW对应i686-w64-mingw32版本的SDL2库
• 确认MinGW的include/SDL2下有完整的SDL头文件，lib下存在libSDL2.dll.a，bin下存在SDL2.dll

4. 清理并重新构建 #

• 删除CMake生成的cmake-build-debug目录
• 在CLion中重新加载CMake配置，执行重新编译操作

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