CMake命令不识别CMakeLists.txt语法的主因是版本过低，需3.10+甚至3.15+；须声明cmake_minimum_required(VERSION 3.15)，显式列出源文件，正确设置C++标准与链接库，避免中文路径。
cmake 命令不识别 CMakeLists.txt 中的语法
常见现象是运行 cmake . 后报错，比如 Unknown CMake command "target_compile_features" 或 Cannot find source file。根本原因不是语法写错，而是 CMake 版本太低——很多现代写法（如 target_compile_features、find_package(... CONFIG)）需要 CMake 3.10+ 甚至 3.15+。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 先查版本：
cmake --version，低于 3.15 的 macOS 用户尤其注意：Homebrew 默认装的是 3.10，brew upgrade cmake才能用新特性 -
CMakeLists.txt开头必须声明最低版本，例如：cmake_minimum_required(VERSION 3.15)，否则 CMake 可能降级兼容模式，导致后续命令失效 - Windows 上用 VS 工具链时，
cmake -G "Visual Studio 17 2022"要配对应版本的 CMake（3.21+），旧版会忽略MSVC_RUNTIME_LIBRARY等关键配置
add_executable 里漏了源文件路径，编译时找不到 main.cpp
典型错误是写了 add_executable(myapp) 却没传源文件，或者用了相对路径但没注意当前工作目录——CMake 不在项目根目录执行时，src/main.cpp 就会报 Cannot find source file。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 永远显式列出源文件：
add_executable(myapp src/main.cpp src/utils.cpp)，别依赖file(GLOB ...)自动发现（它不触发增量重编译） - 路径一律相对于
CMakeLists.txt所在目录，不是 shell 当前路径；构建目录（build/）里执行cmake ..时，所有路径仍以..（即源码根）为基准 - 如果源文件分散，用
set(SOURCES src/main.cpp include/mylib.h)再传给add_executable，比硬编码更易维护
target_link_libraries 链接不到 stdc++fs 或第三方库
现象是链接阶段报 undefined reference to std::filesystem::...，或 cannot find -lmylib。问题不在代码，而在链接顺序和作用域——CMake 默认只对目标本身生效，且 stdc++fs 需要显式启用 C++17 文件系统支持。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 启用 C++17 并链接标准库：
set(CMAKE_CXX_STANDARD 17)+target_link_libraries(myapp PRIVATE stdc++fs)，注意PRIVATE表示仅本目标需要，不传递给依赖者 - 第三方库（如 OpenSSL）要用
find_package(OpenSSL REQUIRED)查找，再target_link_libraries(myapp PRIVATE ${OpenSSL_LIBRARIES})；直接写-lssl会跨平台失败（Windows 是libssl.lib） - 自建库必须先
add_library(mylib STATIC mylib.cpp)，再target_link_libraries(myapp PRIVATE mylib)，顺序不能颠倒
生成的 Visual Studio / Xcode 工程里中文路径乱码或编译失败
Windows 上用中文路径跑 cmake -G "Visual Studio 17 2022"，生成的 sln 文件里路径显示为方块，编译时报 error C1083: Cannot open source file；macOS 上 Xcode 工程里资源路径含中文也会触发类似问题。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 彻底避免中文路径：CMake 本身不处理编码转换，VS/Xcode 工具链读取
CMakeLists.txt生成工程时，会原样写入路径字符串，而 IDE 默认按系统 ANSI 编码解析（Windows 是 GBK） - 若必须支持，Windows 下可临时切到英文 locale：
chcp 65001（UTF-8）再运行 cmake，但 VS 2022 仍可能不识别，稳妥做法是把项目移到C:/dev/project这类纯 ASCII 路径 - macOS 上 Xcode 工程本身支持 UTF-8，但要确保
CMakeLists.txt文件保存为 UTF-8 无 BOM，编辑器别自动转成 UTF-8 with BOM
跨平台构建最麻烦的从来不是语法，而是路径语义和工具链对字符集的隐式假设——哪怕一个空格、一个点号，在不同系统上都可能让 cmake 解析出完全不同的行为。
