首先创建项目结构并编写CMakeLists.txt，然后配置C++标准与头文件路径，接着编写示例代码，通过build目录执行cmake生成构建系统并编译，最后注意跨平台路径与库链接问题。
在现代C++开发中，使用CMake来管理项目已成为标准做法。它能帮助你清晰组织代码结构、简化编译流程，并实现跨平台构建（Windows、Linux、macOS等）。下面是一个实用的C++项目构建与跨平台编译配置教程，带你从零开始使用CMake。
1. 项目基础结构
一个典型的CMake项目目录结构如下：
my_project/├── CMakeLists.txt
├── src/
│ └── main.cpp
└── include/
└── my_header.h
这个结构将源码（src）、头文件（include）和构建配置（CMakeLists.txt）分离，便于维护。
2. 编写根目录 CMakeLists.txt
在项目根目录创建 CMakeLists.txt，内容如下：
立即学习“C++免费学习笔记（深入）”；
cmake_minimum_required(VERSION 3.10)project(MyProject VERSION 1.0 LANGUAGES CXX)
设置C++标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
添加可执行文件
add_executable(${PROJECT_NAME}
src/main.cpp
)
包含头文件目录
target_include_directories(${PROJECT_NAME} PRIVATE include)
说明：
- cmake_minimum_required：指定所需最低CMake版本。
- project：定义项目名称、版本和语言。
- set(CMAKE_CXX_STANDARD ...)：启用C++17标准（也可改为14或20）。
- add_executable：将源文件编译为可执行程序。
- target_include_directories：让编译器能找到头文件。
3. 示例代码：main.cpp 与头文件
include/my_header.h：
#ifndef MY_HEADER_H#define MY_HEADER_H
void say_hello();
endif // MY_HEADER_H
src/main.cpp：
#include iostream>#include "my_header.h"
void say_hello() {
std::cout
}
int main() {
say_hello();
return 0;
}
4. 构建项目（跨平台通用步骤）
打开终端，进入项目根目录，执行以下命令：
mkdir buildcd build
cmake ..
cmake --build .
解释：
- mkdir build：创建独立的构建目录（推荐做法，避免污染源码）。
- cmake ..：读取上级目录的CMakeLists.txt，生成对应平台的构建系统（如Makefile或Visual Studio工程）。
- cmake --build .：调用底层构建工具（make、ninja、MSBuild等）完成编译。
构建成功后，可在build目录下找到生成的可执行文件（如MyProject或MyProject.exe）。
5. 跨平台注意事项
CMake本身是跨平台的，但需注意以下几点：
- 路径分隔符：使用正斜杠 /，CMake会自动处理不同系统的差异。
- 编译器兼容性：确保目标平台安装了支持C++17的编译器（g++、clang、MSVC等）。
-
生成器选择：可通过 -G 指定生成器，例如：
cmake -G "Unix Makefiles" ..
或 Windows 上：
cmake -G "Visual Studio 17 2022" ..
6. 引入第三方库（以静态库为例）
假设你有一个第三方库 libmath.a 和对应的头文件：
# 在CMakeLists.txt中添加add_library(math STATIC IMPORTED)
set_property(TARGET math PROPERTY IMPORTED_LOCATION /path/to/libmath.a)
target_include_directories(math INTERFACE /path/to/math_headers)
链接到主程序
target_link_libraries(${PROJECT_NAME} math)
对于常用库（如Boost、OpenCV），可使用 find_package() 自动查找。
基本上就这些。掌握以上内容后，你已经可以用CMake高效管理中小型C++项目，并轻松实现跨平台编译。随着项目变大，可以进一步学习子目录CMakeLists.txt、函数封装、编译选项控制等高级特性。
