仅头文件库与编译库
在仅头文件库和单独编译的库发行形式之间进行选择
仅头文件库与编译库 是 CoddyKit 上的免费 C++ Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 C++ Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C++ Academy 课程共包含 4 节课。
两种分发模型
C++ 库有两种形式：
- 仅头文件——实现在头文件中；使用方编译全部内容
- 已编译——独立的源文件被编译为静态库或共享库
仅头文件库的优点
优点：
- 集成非常简单——复制并包含即可
- 无需构建配置
- 可跨编译器和标准使用
- 编译器可以积极进行内联
仅头文件库的缺点
缺点：
- 编译速度慢——每个使用方都要重新构建全部内容
- ABI 取决于使用方的编译配置
- 所有使用方都能看到实现
- 如果许多编译单元使用相同模板，会增大二进制文件体积
仅头文件库示例
许多常用库都是仅头文件库：
- nlohmann/json
- spdlog（仅头文件模式）
- cxxopts
- Catch2（仅头文件版本）
已编译库的优点
优点：
- 使用方编译速度快
- 隐藏实现细节
- 模板只实例化一次
- 可以作为二进制文件发布（无需披露源代码）
已编译库的缺点
缺点：
- ABI 兼容性很脆弱
- 库与使用方之间的构建配置必须匹配
- 静态链接会使二进制文件膨胀；动态链接需要运行时加载
静态库与共享库
两种已编译形式：
- 静态（.a、.lib）——在构建时链接到可执行文件中
- 共享（.so、.dll、.dylib）——在运行时加载
模板密集型库
模板不适合以非仅头文件的方式分发——泛型代码会针对每个使用方分别实例化。有些库会将“非模板化”核心编译到 .a 文件中，并为轻量模板提供头文件。
混合方案
有些库同时支持两种方式——单头文件模式便于快速使用，多文件模式则能加快构建。
预编译头文件
如果您的仅头文件库规模较大，预编译头文件（PCH）可以显著加快使用方的构建速度。
模块（C++20）
C++20 模块有望取代头文件，从而改善封装、加快构建，并减少对预处理器的依赖。由于编译器和工具链的支持情况，采用过程较为渐进。
如何选择
快速指南：
- 小型工具库 → 仅头文件
- 实现内容较多的大型库 → 已编译
- 大量使用模板的库 → 仅头文件或混合方案
快速检查
对于使用方来说，仅头文件库最大的缺点是什么？
回顾
仅头文件库易于集成，但会减慢使用方的构建速度。已编译库使用更快，但分发更复杂。模板更适合仅头文件方式；大型实现更适合已编译方式。C++20 模块未来可能取代头文件。
常见问题解答
「仅头文件库与编译库」课时是免费的吗？
是的 — 「仅头文件库与编译库」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C++ Academy 课程的其余内容，请升级到 CoddyKit PRO。 C++ Academy 课程共包含 4 节课。
「仅头文件库与编译库」这节课中我会学到什么？
在仅头文件库和单独编译的库发行形式之间进行选择 你通过在浏览器中直接运行的动手代码来练习 C++ Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 C++ Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 C++ Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「仅头文件库与编译库」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 C++ Academy 课中编写并运行代码吗？
能。每节 C++ Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。