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\

关键点：

项目结构 on 鹿鸣青野的blog

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

一、总体原则

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