MinGW下CMake项目构建失败：库路径错误引发链接器异常

你的错误核心是链接器把完整库路径当成了-l参数后的库名（正常-l应该跟库名，比如-lgomp，而不是-lC:/msys64/mingw64/lib/libgomp.a），这是CMake在MinGW环境下路径格式处理不当导致的，以下是针对性解决方案：

1. 用CMake官方OpenMP模块自动处理 #

不要手动指定库路径，改用CMake内置的FindOpenMP模块，它会自动适配MinGW的路径规则：

# 在CMakeLists.txt中添加
find_package(OpenMP REQUIRED)
# 替换your_target为你的项目目标名
target_link_libraries(your_target PRIVATE OpenMP::OpenMP_CXX) # C项目用OpenMP::OpenMP_C

这种方式会让CMake自动生成正确的链接参数（比如-lgomp），而非硬编码绝对路径。

2. 改用MSYS POSIX风格路径 #

MinGW运行在MSYS Shell下时，优先使用POSIX风格路径而非Windows绝对路径：

• 如果需要手动指定库路径，在CMakeLists.txt中写：

link_directories(/mingw64/lib)

• 环境变量设置时，用POSIX路径：

export LIBRARY_PATH=/mingw64/lib:$LIBRARY_PATH

注：MinGW链接器依赖LIBRARY_PATH而非LD_LIBRARY_PATH，后者是运行时库路径。

3. 清除CMake缓存重新生成 #

之前错误的路径配置可能留在CMake缓存中，执行以下命令重置：

# 进入构建目录
cd your_build_dir
rm -rf CMakeCache.txt CMakeFiles/
# 指定MinGW生成器重新配置
cmake .. -G "MinGW Makefiles"
make

确保指定MinGW Makefiles生成器，避免和MSYS Makefiles混淆。

4. 手动指定库名而非完整路径 #

如果必须手动链接库，直接写库名（去掉lib前缀和.a后缀）：

target_link_libraries(your_target PRIVATE gomp mingwthread)

链接器会自动从默认搜索路径（包括LIBRARY_PATH和系统默认路径）查找对应库文件。

为什么Linux下正常？ #

Linux环境本身使用POSIX路径规则，CMake生成的链接参数是标准的-lgomp，不会出现路径格式混淆的问题；而MinGW需要在Windows路径和POSIX路径之间转换，错误的路径格式会导致链接器误解析参数。

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