C++如何使用CMake构建项目-C++-PHP中文网

cmake报错“no cmakelists.txt”是因为cmake命令仅在指定源目录（如cmake ..中的..）下直接查找该文件，不递归搜索；若执行目录错误、文件缺失、拼写错误或误将构建目录当源目录，均会触发此错，需确认路径、文件存在性及命名准确性。

c++如何使用cmake构建项目

因为 cmake 命令默认只在当前目录查找 CMakeLists.txt，不会递归向上搜索。如果你在子目录执行 cmake .. 却忘了确保父目录存在该文件，就会触发这个错误。

实操建议：

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

始终在项目根目录（即包含 CMakeLists.txt 的目录）下新建一个独立的构建目录，例如 mkdir build && cd build
运行 cmake ..（注意是两个点），让 CMake 读取上层的 CMakeLists.txt
不要把 CMakeLists.txt 放在 src/ 或 app/ 这类子目录里——除非你明确打算只构建那个子模块
如果项目有多个 CMakeLists.txt（比如 submodule/CMakeLists.txt），主文件里必须用 add_subdirectory(submodule) 显式引入，否则它会被忽略

很多初学者卡在语法版本、编译器标准、目标定义这三步。缺一不可，顺序也不能乱。

实操建议：

第一行必须是 cmake_minimum_required(VERSION 3.10)，低于 3.10 会不支持 target_compile_features
紧接着写 project(MyApp LANGUAGES CXX)，显式声明语言，避免某些平台默认启用 C
用 set(CMAKE_CXX_STANDARD 17) 或更推荐的 target_compile_features(mytarget PRIVATE cxx_std_17) 控制标准
可执行文件必须通过 add_executable(myapp main.cpp) 定义，且 main.cpp 路径是相对于 CMakeLists.txt 所在目录的

cmake_minimum_required(VERSION 3.10)
project(MyApp LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
add_executable(myapp main.cpp)

常见原因是：声明了库，但没把它链接给可执行目标；或者用了 add_library(mylib STATIC ...) 却在 target_link_libraries(myapp mylib) 里漏掉 mylib。

实操建议：

静态库（STATIC）编译后生成 .a（Linux/macOS）或 .lib（Windows），链接时把代码直接塞进可执行文件
动态库（SHARED）生成 .so/.dylib/.dll，运行时加载，但必须确保 target_link_libraries 正确引用，且运行时 LD_LIBRARY_PATH（或 DYLD_LIBRARY_PATH）包含路径
如果库和主程序在不同目录，用 target_include_directories(mylib PUBLIC $<include>)</include> 暴露头文件路径，否则 #include "xxx.h" 会失败
别在 add_library() 后立刻用 target_link_libraries() 链接自己——CMake 不允许自链

默认情况下，CMake 把可执行文件放在构建目录顶层（如 build/myapp），不是源码目录。很多人在源码目录里找，自然找不到。

实操建议：

构建完成后直接在 build/ 目录下找，名字就是 add_executable() 第一个参数的值
想统一输出到 build/bin/，加一行：set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
想控制库输出位置，用 CMAKE_ARCHIVE_OUTPUT_DIRECTORY（静态库）和 CMAKE_LIBRARY_OUTPUT_DIRECTORY（动态库）
Windows 下生成的是 .exe 文件，别漏掉后缀；macOS/Linux 没后缀，但可通过 file myapp 确认是否为可执行 ELF/Mach-O