一个跨平台的 C++ CMake 工程模板，支持 Linux (GCC/Clang) 和 Windows (MSVC/Clang/MinGW) 多平台开发。
- ✅ 跨平台构建 — 支持 Linux GCC/Clang + Ninja 和 Windows MSVC/Clang/MinGW + Ninja/Visual Studio
- ✅ 统一构建行为 — MSVC的多配置构建会产生一些难以控制的行为，因此统一为一次只构建一种类型，并强制传入CMAKE_BUILD_TYPE
- ✅ 自动生成 Presets — 一键检测环境，自动生成适配的 CMakePresets.json
- ✅ CTest 集成 — 内置测试支持，
cmake --build后可直接ctest - ✅ CPack 打包 — 一键打包为
.tar.gz（Linux）或.zip（Windows） - ✅ 工作流 Preset — 一条命令完成配置 → 构建 → 测试 → 打包全流程
- ✅ Sanitizer 支持 — 可选启用 AddressSanitizer / UndefinedBehaviorSanitizer / ThreadSanitizer
- ✅ 代码格式化 — 内置
.clang-format（Google 风格） - ✅ 预编译头 — 使用 CMake 3.16+
target_precompile_headers自动注入，大幅加速编译 - ✅ 跨平台项目演示 — 展示了跨平台动态库、静态库、可执行文件的简单案例
- ✅ 多编译器支持 — 同时检测 MSVC、Clang、MinGW GCC、GCC
- ✅ VS Code 深度集成 — 配合 CMake Tools 插件，自动识别 Preset，可视化编译、构建、测试、打包、安装
CMakePresets.json 包含了编译器路径等环境相关配置，不同机器上不同。首次使用项目时，先运行自动检测脚本：
# Linux
./generate_presets.sh
# Windows
generate_presets.bat脚本会自动检测当前环境的：
- 操作系统 — Linux / Windows
- 编译器 — GCC、Clang、MSVC 及其完整版本号（如 14.2.0）
- 构建工具 — Ninja、Unix Makefiles、Visual Studio
生成后即可查看可用的 Preset：
cmake --list-presets# 配置并构建（具体名称以 --list-presets 输出为准）
# Windows 示例：MSVC 17 Debug
cmake --preset msvc17-debug
cmake --build --preset msvc17-debug
# 测试
ctest --preset ctest-msvc17-debug
# 打包
cpack --preset cpack-msvc17-debug
# 安装
cmake --install build/msvc17-debug --config Debug
# 一键工作流
# 配置 → 构建 → 测试 → 打包，一条命令完成：
cmake --workflow --preset workflow-gcc_14.2.0-debug安装 CMake Tools 插件后，插件会自动读取 CMakePresets.json 中的 Preset，从而在可视化界面完成以上操作
CMakePresets.json 由 cmake/GeneratePresets.cmake 自动生成，定义了完整的构建生命周期 Preset，包括 配置 → 构建 → 测试 → 打包 → 工作流 五个阶段。
自动生成的 Preset 名称格式如下（GCC 使用 -dumpfullversion 获取完整版本号，如 14.2.0）：
| 平台 | 配置 Preset 名称 | 说明 |
|---|---|---|
| Linux GCC | gcc_{版本}-debug / gcc_{版本}-release |
如 gcc_14.2.0-debug |
| Linux Clang | clang_{版本}-debug / clang_{版本}-release |
如 clang_20.1.0-debug |
| Windows MSVC | msvc{主版本}-debug / msvc{主版本}-release |
如 msvc17-debug，Visual Studio 多配置生成器 |
| Windows Clang | clang_{版本}-debug / clang_{版本}-release |
如 clang_20.1.0-debug，独立安装的 Clang |
| Windows MinGW | gcc_{版本}-debug / gcc_{版本}-release |
如 gcc_14.2.0-debug，MinGW GCC |
其他 Preset 类型（build、test、package、workflow）的命名均基于配置 Preset 名称派生：
| Preset 类型 | 命名格式 | 示例 |
|---|---|---|
| buildPreset | {配置名称} |
gcc_14.2.0-debug |
| testPreset | ctest-{配置名称} |
ctest-gcc_14.2.0-debug |
| packagePreset | cpack-{配置名称} |
cpack-gcc_14.2.0-debug |
| workflowPreset | workflow-{配置名称} |
workflow-gcc_14.2.0-debug |
配置 Preset 定义了 CMake 的配置参数，包括生成器、编译器、构建类型和输出目录。所有编译器均分 Debug/Release 各一个 Preset，通过 CMAKE_BUILD_TYPE 指定构建类型。
- MSVC / Clang-cl: Visual Studio 多配置生成器，同时设置
CMAKE_BUILD_TYPE和 buildPreset 中的configuration字段 - 独立 Clang / GCC: 单配置生成器（Ninja / Unix Makefiles），仅通过
CMAKE_BUILD_TYPE控制
构建 Preset 关联到对应的配置 Preset。
- MSVC / Clang-cl: 除引用 configurePreset 外，还带有
"configuration"字段（Visual Studio 多配置生成器需要此字段来识别 Debug/Release） - 独立 Clang / GCC: 直接引用 configurePreset 名称
测试 Preset 关联到对应的配置 Preset，用于运行 CTest。
打包 Preset 关联到对应的配置 Preset，用于 CPack 打包。
- Linux: 打包为
.tar.gz，输出到packages/目录 - Windows: 打包为
.zip，输出到packages/目录
工作流 Preset 将 配置 → 构建 → 测试 → 打包 四个步骤串联成一个命令：
cmake --workflow --preset workflow-gcc_14.2.0-debug等价于依次执行：
cmake --preset gcc_14.2.0-debug
cmake --build --preset gcc_14.2.0-debug
ctest --preset ctest-gcc_14.2.0-debug
cpack --preset cpack-gcc_14.2.0-debugCMakePresets.json
├── configurePresets # 配置 Preset（定义编译器、生成器、构建类型）
│ ├── gcc_14.2.0-debug # Linux: GCC 14.2.0 Debug
│ ├── gcc_14.2.0-release # Linux: GCC 14.2.0 Release
│ ├── clang_20.1.0-debug # Linux/Windows: Clang 20.1.0 Debug
│ ├── clang_20.1.0-release # Linux/Windows: Clang 20.1.0 Release
│ ├── msvc17-debug # Windows: MSVC 17 Debug
│ └── msvc17-release # Windows: MSVC 17 Release
│
├── buildPresets # 构建 Preset（关联配置 Preset）
│ ├── gcc_14.2.0-debug # → gcc_14.2.0-debug
│ ├── gcc_14.2.0-release # → gcc_14.2.0-release
│ ├── clang_20.1.0-debug # → clang_20.1.0-debug
│ ├── clang_20.1.0-release # → clang_20.1.0-release
│ ├── msvc17-debug # → msvc17-debug (Debug)
│ └── msvc17-release # → msvc17-release (Release)
│
├── testPresets # 测试 Preset（关联配置 Preset）
│ ├── ctest-gcc_14.2.0-debug # → gcc_14.2.0-debug
│ ├── ctest-gcc_14.2.0-release # → gcc_14.2.0-release
│ ├── ctest-clang_20.1.0-debug # → clang_20.1.0-debug
│ ├── ctest-clang_20.1.0-release# → clang_20.1.0-release
│ ├── ctest-msvc17-debug # → msvc17-debug (Debug)
│ └── ctest-msvc17-release # → msvc17-release (Release)
│
├── packagePresets # 打包 Preset（关联配置 Preset）
│ ├── cpack-gcc_14.2.0-debug # → gcc_14.2.0-debug
│ ├── cpack-gcc_14.2.0-release # → gcc_14.2.0-release
│ ├── cpack-clang_20.1.0-debug # → clang_20.1.0-debug
│ ├── cpack-clang_20.1.0-release# → clang_20.1.0-release
│ ├── cpack-msvc17-debug # → msvc17-debug
│ └── cpack-msvc17-release # → msvc17-release
│
└── workflowPresets # 工作流 Preset（串联多个 Preset）
├── workflow-gcc_14.2.0-debug # configure → build → test → package
├── workflow-gcc_14.2.0-release # configure → build → test → package
├── workflow-clang_20.1.0-debug # configure → build → test → package
├── workflow-clang_20.1.0-release # configure → build → test → package
├── workflow-msvc17-debug # configure → build → test → package
└── workflow-msvc17-release # configure → build → test → package
以上名称仅为示例，实际生成的名称取决于你环境中检测到的编译器类型和版本。
- 调试信息:
-g3（GCC/Clang）//Zi（MSVC）— 最详细的调试信息 - 优化:
-O0（GCC/Clang）//Od（MSVC）— 禁用优化，方便调试 - 帧指针: 保留帧指针，获得更好的堆栈回溯
- 后缀: 可执行文件自动添加
d后缀（如project1d）
- 优化: 默认启用最高优化级别
- 可选: 可通过 CMake 变量开启 Release 模式的调试信息或禁用优化
在配置时通过 CMake 变量启用：
# 启用 AddressSanitizer（检测内存错误）
cmake --preset gcc_14.2.0-debug -DENABLE_FSANITIZE_ADDRESS=ON
# 启用 UndefinedBehaviorSanitizer（检测未定义行为）
cmake --preset gcc_14.2.0-debug -DENABLE_FSANITIZE_UNDEFINED=ON
# 启用 ThreadSanitizer（检测数据竞争）
cmake --preset gcc_14.2.0-debug -DENABLE_FSANITIZE_THREAD=ON项目参考 Google C++ 风格指南，配置文件为 .clang-format。
# Linux
./clean_all.sh
# Windows
clean_all.bat
# 或使用 CMake 自定义目标
cmake --build build/gcc_14.2.0-debug --target clean_all_binary本项目基于 MIT License 开源。