如何在Visual Studio编译的CMake项目中正确设置调试标志

问题描述 #

• 跨平台C++ CMake项目，支持Linux/Windows双平台，Windows端使用Visual Studio/MSVCC编译
• 已在CMake和VS中设置为Debug构建模式，但VS构建后未生成调试符号，无法进行调试
• 查看VS构建详细输出，出现警告：cl : command line warning D9002: ignoring unknown option '-g'
• 项目原CMake核心配置如下：

SET(CMAKE_CXX_STANDARD 17)
SET(CMAKE_CXX_STANDARD_REQUIRED ON)
SET(BUILD_MODE Debug)
SET(CMAKE_CXX_FLAGS "-Wall")
SET(CMAKE_CXX_FLAGS_DEBUG "-g")
SET(CMAKE_CXX_FLAGS_RELEASE "-O3")

• 项目依赖QT库

问题根源 #

1. 手动覆盖CMAKE_CXX_FLAGS系列变量破坏默认配置：

   • 直接使用SET(CMAKE_CXX_FLAGS "-Wall")会完全替换CMake针对不同编译器（MSVCC/GCC/Clang）的默认编译选项，导致MSVCC的Debug模式丢失了/Zi（生成调试符号的核心参数）等关键配置
   • 手动设置的CMAKE_CXX_FLAGS_DEBUG "-g"是GCC/Clang的调试符号生成参数，MSVCC不识别该参数，因此触发D9002警告

2. BUILD_MODE变量无影响：
   该变量是项目自定义的统一构建模式配置项，实际项目已正确映射到CMAKE_BUILD_TYPE，并非问题诱因

解决方案 #

1. 移除手动设置的CMAKE_CXX_FLAGS相关配置：
   删除CMakeLists.txt中以下行：

   SET(CMAKE_CXX_FLAGS "-Wall")
   SET(CMAKE_CXX_FLAGS_DEBUG "-g")
   SET(CMAKE_CXX_FLAGS_RELEASE "-O3")
   

   恢复CMake的默认编译选项后，MSVCC的Debug模式会自动启用/Zi生成调试符号，GCC/Clang也会自动使用-g等对应正确参数，跨平台兼容性自动保障

2. 后续添加编译选项的正确姿势：
   如果需要添加额外编译选项（如警告、优化参数），避免直接覆盖默认变量，应使用带有_INIT后缀的变量：

   • 给所有构建模式添加通用选项：

     SET(CMAKE_CXX_FLAGS_INIT "-Wall")
     

   • 给Debug模式追加选项：

     SET(CMAKE_CXX_FLAGS_DEBUG_INIT "${CMAKE_CXX_FLAGS_DEBUG_INIT} -g")
     

   更推荐的方式是使用target_compile_options针对具体目标添加选项，既能保证灵活性，也能避免全局配置冲突

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