如何在CMake中链接静态库？链接GLFW时遇未定义引用错误

你的CMake配置里有几个关键错误导致了链接失败，我来帮你一步步修正：

问题根源分析 #

你的CMakeLists.txt里有一行完全错误的代码：

add_library(glfw3 STATIC main.cpp)

这行命令是把你自己的main.cpp编译成一个名为glfw3的静态库，这和你要链接的真正GLFW库完全冲突，直接导致链接器找不到正确的GLFW函数实现。另外，find_library的用法也不够规范，还有Windows下静态链接GLFW需要额外依赖系统库。

修正后的CMakeLists.txt #

替换成下面的配置，我会逐行解释：

cmake_minimum_required(VERSION 3.15)
project(testo)
set(CMAKE_CXX_STANDARD 17)

# 生成你的可执行文件
add_executable(testo main.cpp)

# 只给testo目标添加GLFW的头文件路径（比全局include更规范）
target_include_directories(testo PRIVATE lib/glfw/include/)

# 查找GLFW静态库：指定库名称和搜索路径
find_library(GLFW_LIBRARY 
             NAMES glfw3 libglfw3.a  # 根据你的实际库文件名调整，Windows MinGW下可能是libglfw3.a
             PATHS lib/glfw/lib       # GLFW库文件所在的目录
             NO_DEFAULT_PATH)         # 只在指定路径搜索，避免干扰

# 链接GLFW和系统依赖库（Windows下必须添加这些系统库）
if(WIN32)
    target_link_libraries(testo PRIVATE ${GLFW_LIBRARY} user32 gdi32 shell32)
else()
    target_link_libraries(testo PRIVATE ${GLFW_LIBRARY})
endif()

关键修正点说明 #

1. 移除错误的add_library行：这行是核心错误，直接删掉就好。
2. 使用target_include_directories：相比全局的include_directories，这种方式只给你的可执行文件添加头文件路径，避免污染其他目标。
3. 规范find_library用法：用NAMES列出可能的库文件名（不同编译环境的库命名有差异），PATHS指定GLFW库的存放路径，确保CMake能找到正确的库文件。
4. 添加Windows系统依赖：静态链接GLFW时，它依赖Windows的user32、gdi32、shell32系统库，必须显式链接这些库才能解决额外的未定义引用问题。

额外注意事项 #

• 确认你的GLFW静态库和编译环境匹配：从错误日志里的mingw32-make能看出来你用的是MinGW，那你下载的GLFW库必须是MinGW编译版本，不能用MSVC版本的库，否则会出现链接错误。
• 检查lib/glfw/lib目录下确实存在对应的静态库文件（比如libglfw3.a或者glfw3.lib）。

内容的提问来源于stack exchange，提问作者128 bit guy