新建空文件无效，因cmake强制要求首行为cmake_minimum_required(version 3.10)，且文件须为utf-8无bom、大小写精确的cmakelists.txt；漏写该行或存在bom/错误命名即报错退出。
CMakeLists.txt 文件不能“创建”就完事，它必须放在项目根目录且内容符合 CMake 语法，否则 cmake 命令会直接报错退出。
为什么新建一个空文件没用？
因为 CMake 不识别空文件或仅含注释的文件。运行 cmake . 时，它会查找 CMakeLists.txt 并解析第一行的 cmake_minimum_required() —— 这是强制要求。
- 漏写
cmake_minimum_required(VERSION 3.10)→ 报错：CMake Error: The source directory ".../myproj" does not appear to contain CMakeLists.txt（即使文件存在，CMake 也认为无效） - 版本写太低（如
2.8）→ 在新系统上可能触发策略警告或功能不可用 - 文件名写成
CMakeLists.TXT或CMakeLists.txt.bak→ Linux/macOS 下完全不识别（大小写敏感 + 后缀必须精确）
最简可用的 CMakeLists.txt 长什么样？
针对单个可执行文件项目（比如 main.cpp），三行足够启动：
cmake_minimum_required(VERSION 3.10) project(MyApp LANGUAGES CXX) add_executable(myapp main.cpp)
说明：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
project()必须在cmake_minimum_required()之后、任何目标定义之前；LANGUAGES CXX显式声明用 C++，避免 CMake 默认只开 C 支持 -
add_executable()的第一个参数是生成的可执行文件名（不带.exe），第二个是源文件路径（相对当前CMakeLists.txt所在目录） - 如果源文件在
src/子目录，要写成src/main.cpp，不能指望 CMake 自动递归找
常见错误：加了 find_package() 却编译失败
比如想用 OpenCV，写了 find_package(OpenCV REQUIRED)，但没接后续链接动作，会导致链接时报 undefined reference。
- 必须配对使用：
find_package(OpenCV REQUIRED)+target_link_libraries(myapp ${OpenCV_LIBS}) - 注意变量名：CMake 2.x 常用
${OpenCV_LIBS}，3.10+ 更推荐target_link_libraries(myapp ${OpenCV_LIBRARIES})或直接target_link_libraries(myapp opencv_core opencv_imgproc) - 如果
find_package()失败，CMake 会中止并提示Could not find a package configuration file...，此时要检查 OpenCV 是否已安装，或通过-DOpenCV_DIR=...指定其OpenCVConfig.cmake路径
Windows 上容易忽略的路径和换行问题
用记事本保存 CMakeLists.txt 可能引入
或 BOM（UTF-8 with signature），导致 Linux/macOS 下 cmake 解析出错，报类似 Parse error on line 1 的模糊错误。
- 务必用 VS Code、Notepad++ 或 Vim 等编辑器，保存为 UTF-8 无 BOM 格式
- 检查换行符：Linux/macOS 应为
file CMakeLists.txt查看编码和行尾类型 - 路径分隔符统一用正斜杠
/（CMake 内部自动适配 Windows），不要写\或混合使用
真正卡住人的往往不是语法多难，而是 CMake 对文件位置、命名、编码、版本声明这些“前置条件”极其严格——少一行 cmake_minimum_required，或多一个 BOM，整个构建就停在第一步。
