cmake 调试常见错误总结（持续更新）

1. cmake 总体排查思路：

CMake调试中的问题可以归纳为配置、构建、链接和环境几个阶段。下表汇总了最常见的问题、表现及解决思路。

错误类型	典型表现 / 核心原因	核心解决方法与工具
配置阶段错误	变量值不符合预期、找不到包、条件分支错误。	使用 message() 输出调试；使用 cmake -L 或查看 CMakeCache.txt 检查缓存变量。
构建/生成失败	生成Makefile/项目文件时出错，例如找不到源文件、语法错误。	仔细检查CMake输出的错误信息；使用 variable_watch() 监控关键变量。
编译链接错误	编译通过但链接失败，例如 undefined reference；库路径或名称不对。	使用 get_target_property() 检查目标的链接库；确保find_package正确。
调试器启动失败	在IDE（如VSCode）中调试无法启动，提示找不到可执行文件或断点无效。	确保构建类型为 Debug 以生成调试符号；检查 launch.json 中 program 路径是否与构建输出完全匹配。
环境与兼容性	升级编译器或CMake后出现链接错误或策略警告。	解决库的ABI不匹配问题；使用 cmake_policy 处理新版本的策略警告。

2. 自己调试过程中出现的问题解决（会持续的更新）

2.1 Ignoring extra path from command line

完整告警如下：
CMake Warning:
Ignoring extra path from command line:
".."
CMake Error: The source directory "D:/build/Project/hello_world" does not appear to contain CMakeLists.txt.
Specify --help for usage, or press the help button on the CMake GUI.
这个原因是：cmakelists 文件不存在，或者是拼写错误，例如我自己的文件名就CMakeList， 少一个s，自己尝试了cmakelists 这样的全小写也是没有错的。

2.2 CMake Error: The source directory "xxx" does not exist.

这个原因是使用cmak命令进行配置的时候，后面填写的路径不对，导致无法找到顶层的CMakeLists.txt
示例：
cmake ./wlan_mac 希望CMakeListst.txt 在目录wlan_mac, 但是他不在。

2.3 Cannot find source file:

这个原因是使用cmake 进行配置的时候，没有找到相应的源文件。
示例：
file(GLOB ARCH_SRC "./arch/src/.c") 这是错误的当时理解在linux下./表示当前目录，在cmake中指定路径时，使用绝对路径或者时相对路径都可以，如果时相对目录时应该使用file(GLOB ARCH_SRC "${CMAKE_CURRENT_SOURCE_DIR}/arch/src/.c")，用CMAKE_CURRENT_SOURCE_DIR来表示相对路径，在这个路径一下一定要有源代码。

2.4 No SOURCES given to target

这个原因是使用cmake 进行配置的时候，使用add_executable命令时，没有找到任何的源代码。
示例：

# 方法1：按模块收集
file(GLOB ARCH_SRC "${CMAKE_CURRENT_SOURCE_DIR}/arch/src/*.c")
file(GLOB LAYER1_SRC "${CMAKE_CURRENT_SOURCE_DIR}/layer1/src/*.c")
file(GLOB LAYER2_SRC "${CMAKE_CURRENT_SOURCE_DIR}/layer2/src/*.c")
file(GLOB LAYER3_SRC "${CMAKE_CURRENT_SOURCE_DIR}/layer3/src/*.c")

# 主可执行文件
add_executable(wlan_dev ARCH_SRC LAYER1_SRC LAYER2_SRC LAYER3_SRC)

add_executable(wlan_dev ARCH_SRC LAYER1_SRC LAYER2_SRC LAYER3_SRC) 这个语句错误，代码列表变量引用时没有用${}这样的格式，导致配置wlan_dev这样的目标时，没有任何的源文件，正确的命令是add_executable(wlan_dev ${ARCH_SRC} ${LAYER1_SRC} ${LAYER2_SRC} ${LAYER3_SRC})

2.5 Invalid character ('*') in a variable name:

这个原因经常是编码没有赋值

# 错误：星号被当作特殊字符解析
set(SRCS *.cpp *.h)

# 正确：使用引号
set(SRCS "*.cpp" "*.h")