1 / 4概念
Feature: Templates
模板是 C++ 的编译期代码生成机制:用类型或值参数化函数与类,在实例化点生成具体代码。判断标准是能否说出每个模板在哪些点被实例化、约束如何过滤候选、生成代码增加了多少体积与编译时间。
1 概念
1.1 一句话定义
模板包括函数模板、类模板、变量模板与别名模板;实例化用具体实参替换形参;全特化与偏特化为特定类型提供实现;变参模板用参数包接受任意数量实参;SFINAE 与 concepts 约束候选;代价是单态化带来的代码体积与编译时间。
1.2 它解决什么问题
- 容器与算法对任意类型复用,同时保留类型检查。
- 零成本抽象:实例化后的代码可内联,不引入运行期分派。
- 编译期计算与静态校验,把错误前移。
- 用 concepts 写出可读的约束与错误信息。
代价是编译变慢、二进制变大、错误信息变长。
1.3 不属于本页的内容
类型推导、引用与 cv 见 Type;移动与完美转发见 Feature: Move Semantics;类继承与虚函数见 OOP;CRTP mixin 见 AOP;宏与预处理见 C 的 Feature: Preprocessor;构建配置见 Toolchain。
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| template parameter | 模板形参 | 分为类型、非类型与模板模板 |
| instantiation | 用实参生成具体代码 | 每个 TU 可能各生成一份 |
| full specialization | 为特定实参提供实现 | 不是重载 |
| partial specialization | 为部分模式提供实现 | 只适用于类模板 |
| variadic template | 接受任意数量实参 | 用参数包展开 |
| parameter pack | 参数包 | sizeof... 取数量 |
| SFINAE | 替换失败不是错误 | 错误信息通常很差 |
| concept | 命名的约束 | C++20 起 |
| requires | 约束子句或表达式 | 可用于函数与类模板 |
2 机制
2.1 心智模型
模板是“编译器执行的替换 + 重载决议”。实例化发生在使用点,模板定义必须对使用点可见,因此通常放在头文件;每个 TU 各自实例化,链接器再合并。两阶段查找让非依赖名字在定义时解析、依赖名字在实例化时解析;concepts 把约束纳入重载决议,避免用 SFINAE 制造难读的错误。
2.2 机制拆解
- 模板种类:函数模板、类模板、变量模板、别名模板与成员模板。
- 推导与 CTAD:模板实参推导、引用折叠、
auto;C++17 的类模板实参推导与 deduction guide。 - 特化:全特化可为函数与类;偏特化只适用于类模板;显式实例化与
extern template控制生成位置。 - 变参模板:
template<class... Ts>、参数包展开、sizeof...(Ts)、C++17 折叠表达式。 - SFINAE:替换失败只移除候选,不报错;
enable_if_t、void_t与尾置返回类型是常见写法。 - concepts:
concept C = requires(...) { ... };;requires子句约束模板;标准库在<concepts>中提供std::integral与std::ranges::range。 - 两阶段查找:依赖名字要加
typename或template消歧;ADL 在实例化期参与。 - 代码生成:单态化为每个实参组合生成一份;内联与常量折叠带来性能,也带来体积与编译时间。
2.3 完整枚举
C++ 的模板形参种类:
| 种类 | 语法 | 示例 | 限制 |
|---|---|---|---|
| 类型参数 | class T / typename T | template<class T> void f(T); | 最常见 |
| 非类型参数 | int N、auto N | template<int N> struct A; | 必须是常量表达式 |
| 模板模板参数 | template<class> class C | template<template<class> class C> struct X; | 实参须匹配形参列表 |
| 类型参数包 | class... Ts | template<class... Ts> void f(Ts...); | 用 sizeof... 取数量 |
| 非类型参数包 | int... Ns | template<int... Ns> struct A; | 每个实参是常量 |
| 模板模板参数包 | template<class> class... Cs | template<template<class> class... Cs> struct X; | 组合爆炸风险 |
3 实践
3.1 最小示例
#include <concepts>
#include <cstddef>
#include <cstdio>
template <class T>
concept Addable = requires(T a, T b) { a + b; };
template <Addable T>
T sum(T first) { return first; }
template <Addable T, Addable U, Addable... Rest>
T sum(T first, U second, Rest... rest) {
return first + sum(second, rest...);
}
template <class... Ts>
std::size_t count(const Ts&...) { return sizeof...(Ts); }
template <class T>
struct TypeName { static constexpr const char* value = "unknown"; };
template <>
struct TypeName<int> { static constexpr const char* value = "int"; };
int main() {
std::printf("%d %g\n", sum(1, 2, 3), sum(1.5, 2.5));
std::printf("%zu %s\n", count(1, "a", 3.0), TypeName<int>::value);
}
追踪:Addable 约束要求 a + b 合法,sum(1, 2, 3) 推导 T = int、U = int、Rest = {int},递归到 sum(3) 命中单参数重载;sum(1.5, 2.5) 生成 double 版本。count 只用 sizeof...(Ts),不访问实参,生成三个不同 Ts 的实例。TypeName<int> 命中全特化,输出 int。每个实例都是一份独立代码:调用点越多、类型组合越多,编译时间与二进制越大。
3.2 标准流程
- 先写具体类型版本,确认逻辑后再提取模板。
- 用 concepts 写约束,不用 SFINAE 表达新代码。
- 模板定义放头文件;需要控制体积时用显式实例化与
extern template。 - 用
static_assert给出可读的失败原因,并测试多组类型。
3.3 选型矩阵
| 需求 | 选择 | 代价 |
|---|---|---|
| 编译期多态 | 函数/类模板 | 代码体积、编译时间 |
| 运行期多态 | 虚函数 | 间接调用 |
| 约束类型 | concepts + requires | 需要 C++20 |
| 条件编译 | if constexpr | 丢弃分支仍须语法合法 |
| 任意数量参数 | 变参模板 | 展开与递归成本 |
| 特定类型特例 | 全特化/偏特化 | 维护两套逻辑 |
| 减少实例化 | extern template、类型擦除 | 一层间接 |
| 编译期校验 | static_assert | 错误信息设计成本 |
3.4 决策规则
- 只有存在多个类型组合或明确零成本需求时才模板化。
- 约束写“真正用到的操作”,不要复制整个类型接口。
- 不要在头文件里堆重模板;用 pimpl 或类型擦除隔离实现。
- 模板错误信息是 API 的一部分,用 concepts 与
static_assert改善。
4 边界
4.1 典型故障
| 症状 | 根因 | 诊断 | 修复 |
|---|---|---|---|
| 编译错误长达数百行 | 深层实例化与 SFINAE 失败 | -ftemplate-backtrace-limit | 改 concepts、加 static_assert |
| 二进制体积膨胀 | 每个实参组合生成一份代码 | nm、bloat 工具 | extern template、类型擦除 |
| 链接报模板符号未定义 | 定义对使用点不可见 | nm 查符号 | 定义移到头文件或显式实例化 |
| 依赖名字解析失败 | 缺少 typename/template | 编译器错误定位 | 补消歧关键字 |
| “no matching function” 难定位 | SFINAE 静默移除候选 | 注释约束逐步二分 | 改 concepts 并加诊断 |
| 不同 TU 的模板行为不同 | ODR 违规,定义不一致 | LTO 警告 | 统一定义与宏 |
| 模板递归深度超限 | 递归实例化过深 | 编译错误中的深度 | 改折叠表达式或迭代 |
| 编译时间不可接受 | 头文件与实例化过多 | -ftime-trace | 预编译头、模块、类型擦除 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 为一次性逻辑写模板 | 编译变慢、可读性差 | 普通函数 |
| 用 SFINAE 写新约束 | 错误信息不可读 | concepts |
| 在头文件暴露实现细节 | 编译耦合 | pimpl/类型擦除 |
| 对所有类型无差别实例化 | 代码膨胀 | 约束 + extern template |
4.3 可观测信号
编译期看 -ftime-trace 的实例化热点、模板深度、错误信息长度与二进制符号数。运行期看内联效果、代码缓存命中与指令缓存压力。构建侧看头文件依赖图与增量编译时间。
4.4 安全 / 性能 / 一致性边界
- 安全:模板只做编译期检查;约束不满足时是编译错误,不是运行期错误。
- 性能:单态化通常零运行期开销,但代码体积会压低指令缓存命中率。
- 一致性:模板定义、宏与编译选项必须跨 TU 一致,否则 ODR 违规产生难查的行为差异。