本文探讨了大型 C++ 项目中管理代码依赖的五种主流方案，包括 Git 子模块、包管理器（如 vcpkg、conan）、预编译库文件、符号链接以及单体仓库（Monorepo）。每种方案均有其适用场景与优缺点。对于学习阶段建议手动复制，课程项目建议附加包含目录，个人开源推荐 Git 子模块加 CMake，工作企业项目则推荐使用 vcpkg 或 conan 配合 CMake。文章提供了详细的配置示例与对比表格，帮助开发者根据实际需求选择合适的依赖管理策略，避免手动复制带来的维护问题。
大型项目绝对不会那样手动复制文件，也不会简单地添加现有项。他们有成熟的工程化方案。
原理：把依赖的代码作为独立的 Git 子模块或独立项目，通过构建系统链接。
MyLargeProject/
├── src/
│ └── main.cpp
├── third_party/ ← 第三方代码
│ ├── xlog/ ← Git Submodule
│ │ ├── CMakeLists
│ │ └── /
│ └── json/ ← Git Submodule
│ └── ...
├── CMakeLists ← 顶层构建配置
└── ← 子模块配置
工作流程：
# 克隆时自动拉取子模块
git clone --recursive https://github.com/xxx/MyLargeProject.git
# 构建时自动编译所有子项目
cmake -B build
cmake --build build
优点：
缺点：
原理：像 npm/pip 一样，用命令安装依赖，自动下载 + 编译 + 链接。
| 包管理器 | 适用场景 | 命令示例 |
|---|---|---|
| vcpkg | Microsoft 官方，Windows 首选 | vcpkg install xlog |
| conan | 跨平台，C++ 专用 | conan install xlog/1.0 |
| nuget | .NET + C++ 混合项目 | nuget install xlog |
工作流程：
# 1. 安装依赖
vcpkg install xlog
# 2. 在 CMakeLists.txt 中引用
find_package(xlog CONFIG REQUIRED)
target_link_libraries(my_app PRIVATE xlog::xlog)
# 3. 构建
cmake -B build -DCMAKE_TOOLCHAIN_FILE=vcpkg/scripts/buildsystems/vcpkg.cmake
优点：
缺点：
原理：依赖方只提供 .lib/.dll + 头文件，不暴露源码。
MyProject/
├── src/
│ └── main.cpp
├── lib/
│ ├── xlog.lib ← 预编译库
│ └── xlog.dll
├── include/
│ └── xlog/
│ └── xlog.h ← 头文件
└── CMakeLists.txt
配置方式：
# CMakeLists.txt
include_directories(${PROJECT_SOURCE_DIR}/include)
link_directories(${PROJECT_SOURCE_DIR}/lib)
target_link_libraries(my_app PRIVATE xlog.lib)
优点：
缺点：
原理：用系统级符号链接，让文件看似在项目目录，实际在别处。
Windows 命令：
# 管理员权限运行
mklink /D src\xlog D:\SharedLibs\xlog
Linux/Mac：
ln -s /SharedLibs/xlog src/xlog
优点：
缺点：
原理：所有代码放在一个超大仓库里，用构建系统按需编译。
GoogleMonorepo/
├── BUILD ← 顶层构建配置
├── third_party/
│ ├── google/
│ │ ├── logging/
│ │ ├── testing/
│ │ └── ...
└── tools/
工具：Bazel、Buck、Please
优点：
缺点：
| 方案 | 适用场景 | 学习成本 | 推荐度 |
|---|---|---|---|
| Git 子模块 | 开源项目、多团队协作 | 中 | ⭐⭐⭐⭐⭐ |
| 包管理器 | 现代化项目、第三方依赖 | 中 | ⭐⭐⭐⭐⭐ |
| 预编译库 | 商业库、闭源依赖 | 低 | ⭐⭐⭐⭐ |
| 符号链接 | 个人开发、本地多项目 | 低 | ⭐⭐⭐ |
| Monorepo | 超大型企业、多产品线的公司 | 高 | ⭐⭐⭐⭐ |
| 阶段 | 推荐方案 | 理由 |
|---|---|---|
| 学习/练手 | 手动复制文件 | 简单直接，避免工具干扰学习 |
| 课程项目 | 附加包含目录 + 引用 | 符合教学要求，配置清晰 |
| 个人开源项目 | Git 子模块 + CMake | 标准化，方便他人贡献 |
| 工作/企业项目 | vcpkg/conan + CMake | 行业主流，可维护性强 |
根据你当前的情况（学习阶段，两个项目在同一解决方案）：
| 资源 | 链接 |
|---|---|
| vcpkg 官方文档 | https://vcpkg.io/ |
| CMake 入门教程 | https://cmake.org/cmake/help/latest/guide/tutorial/index.html |
| Git Submodule 详解 | https://git-scm.com/book/zh/v2/Git-工具 - 子模块 |
总结：大型项目不是不复制文件，而是用更聪明的方式管理复制和引用。你现在遇到的坑，正是理解这些工程化方案的最好起点！
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online