工具链 on 鹿鸣青野的blog

C++ 项目约定：目录结构、依赖管理、构建与 Git

Tue, 13 Oct 2026 00:00:00 +0000

所谓「约定」= 一套项目结构规范 + 依赖管理规范：以后不管做什么项目，都按这个套路来，不用每次重新想。

适用背景：Windows（VS2022）只做 Boost + OpenCV，不做 Qt；Qt 开发放在 Linux（Ubuntu 虚拟机/服务器）。

文中 <OpenCV安装目录>、<Boost根目录>、<项目根目录> 为占位符，替换成本机实际目录即可。

一、总体原则

三句话：

CMake 是唯一的构建系统，不碰 qmake、不碰手动 .vcxproj。
依赖一律走环境变量 + find_package，不在 CMakeLists.txt 里硬编码路径。
Windows 端 IDE 是 VS2022 + CMake 项目模式；Linux 端用 Qt Creator 或 VS Code。

二、目录结构约定（Windows 端）

每个项目固定长这样：

<项目根目录>\<项目名>\
├── CMakeLists.txt
├── CMakePresets.json
├── CMakeUserPresets.json # 本地预设（不提交 Git）
├── .gitignore
├── README.md
├── src\ # 源码
│ ├── main.cpp
│ ├── core\ # Boost 业务逻辑
│ │ ├── Service.h
│ │ └── Service.cpp
│ └── vision\ # OpenCV 图像处理
│ ├── ImageProcessor.h
│ └── ImageProcessor.cpp
├── include\ # 对外头文件（可选）
├── resources\ # 静态资源、图片（可选）
├── tests\ # 测试代码（可选）
├── third_party\ # 第三方源码（可选，一般不用）
└── out\ # 构建输出（不提交 Git）
 └── build\
 ├── debug\
 └── release\

关键点：

VS 向导 vs CMake 手建工程：一次取舍记录

Tue, 13 Oct 2026 00:00:00 +0000

新建 C++ 项目时，用 VS2022 项目向导，还是手建目录 + CMake？核心结论：向导是「快」，CMake 手建是「稳」；长期维护的 Boost + OpenCV 项目走 CMake 手建路线。

一、「完全不利用 VS 向导」指什么

VS 新建项目时，向导会自动生成：

目录结构
.vcxproj / .sln
一些默认代码
默认的编译配置

不用向导，就是自己手建目录、手写 CMakeLists.txt、用 VS 的「打开文件夹」模式加载。

二、CMake 手建的好处

#	好处	说明
1	结构清晰、可控	向导生成的项目，目录和配置是向导定的；手建时 `src/`、`include/`、`resources/`、`tests/` 怎么分，自己说了算
2	跨平台	`CMakeLists.txt` 是跨平台的：同一个项目，Windows 用 MSVC，WSL 用 GCC，不用改任何东西；向导生成的 `.vcxproj` 只能在 VS 里用
3	依赖管理统一	Boost、OpenCV 全走 `find_package`，环境变量一配，所有项目通用；向导的项目要手动一个个加 include、lib 路径
4	不污染仓库	`.vcxproj`、`.sln`、`.vs/`、`out/` 都是本地文件，不进 Git；CMake 项目只需提交 `CMakeLists.txt` 和源码，干净
5	和工业界一致	大多数 C++ 开源项目、跨平台项目都用 CMake；养成这个习惯，以后参与别人的项目、或自己发布项目，都顺
6	配置一次、项目复用	环境变量和 `CMakeLists.txt` 模板定好后，新建项目就是复制模板、改项目名、加源文件。增量配置，不是每次从零配

三、CMake 手建的代价

初期配置复杂。第一次要理解：CMakeLists.txt 的语法、find_package 怎么找库、环境变量怎么设、CMakePresets.json 的格式。这些概念对新手是门槛。
VS 集成不如原生项目「顺滑」。向导项目是 VS 原生支持，调试、IntelliSense 开箱即用；CMake 项目通过「打开文件夹」或「CMake 项目」模式支持，功能也全，但偶尔会遇到配置识别问题。
调试和 IDE 功能偶有摩擦。断点、监视窗口、调用栈这些都没问题；但某些 VS 特有的功能（比如某些项目属性页面），在 CMake 项目里没有对应入口。
学习曲线。要同时学 CMake、学 Boost/OpenCV 的 CMake 配置。一次性投入大，但长期收益高。

四、取舍小结

整体体验是：结构清晰，配置相对复杂；不过做项目时配置一次，后续只是增量配置。

VS2022 打开 CMake 项目的调试说明：断点与 launch.vs.json

Tue, 13 Oct 2026 00:00:00 +0000

手建的 CMake 项目在 VS2022「打开文件夹」模式下的打开方式、自动生成的配置、断点调试与 launch.vs.json。核心结论：CMake 项目的调试体验与向导项目基本一致，唯一多出的一步是手动选启动目标。

一、怎么用 VS 打开手建的 CMake 项目

步骤：

VS2022 → 文件 → 打开 → 文件夹。
选项目根目录，比如 <项目根目录>\MyProject。
VS 自动识别 CMakeLists.txt，切换到 CMake 项目模式。

VS 会自动做的事：

读 CMakeLists.txt，配置 CMake。
在项目根目录生成 .vs/，存 VS 自己的状态。
在 out/build/ 下生成构建产物。
底部状态栏出现 配置选择器（Debug/Release），和 CMake 目标选择器。

和向导项目一样，VS 该自动生成的还是会生成。

二、VS 自动生成的配置有哪些

和向导项目时一样：

.vs/：VS 的工作状态、索引、窗口布局。不提交 Git。
out/：CMake 构建产物。不提交 Git。
CMakeUserPresets.json：如果在 VS 里改过预设，它可能生成这个。不提交 Git。

这些不影响项目结构本身，只是 VS 的本地缓存，删了能重建。

三、断点怎么用

CMake 项目的断点和向导项目完全一样。

基本流程

在代码行号左边点一下，出现红点，就是断点。
按 F5 启动调试（不是 Ctrl+F5，Ctrl+F5 是不调试直接运行）。
程序运行到断点处停下，VS 自动切换到调试界面。
底部出现调试工具栏：继续、单步跳过、单步进入、跳出。
左侧或底部窗口：局部变量、监视、调用栈、断点列表。

常用快捷键

操作	快捷键
启动调试	`F5`
停止调试	`Shift + F5`
单步跳过（不进入函数）	`F10`
单步进入（进入函数）	`F11`
跳出当前函数	`Shift + F11`
继续运行	`F5`
切换断点	`F9`
条件断点	右键断点 → 条件

CMake 项目特有的注意点

1. 启动目标