g++/clang 的 -ftemplate-depth 默认值是 900；该值限制模板实例化链长度而非调用栈深度，GCC 7+ 和 Clang 6+ 均采用此默认值，可通过 -ftemplate-depth=N 调整。
g++/clang 的 -ftemplate-depth 默认值是多少？
C++ 模板递归展开时，编译器会限制嵌套层数，防止栈溢出或无限展开。g++ 和 clang 默认的模板实例化深度是 900 层（注意：不是调用栈深度，是模板实例化链长度）。这个值在遇到深度元编程（比如类型列表折叠、递归 constexpr 计算、Boost.MP11 或现代 std::tuple 操作）时很容易撞墙。
- 实际触发错误时，你会看到类似：
error: template instantiation depth exceeds maximum of 900 - 这个限制只作用于模板实例化（instantiation），不影响函数调用或 constexpr 递归执行
- 不同编译器版本可能略有差异，但 900 是 GCC 7+ 和 Clang 6+ 的通用默认值
调整方法很简单：g++ -ftemplate-depth=2000 或 clang++ -ftemplate-depth=2000。数值设太高也没用——超过 10000 后编译内存和时间增长非线性，且很多问题其实该重构而非硬堆深度。
MSVC 的等效参数是 /bigobj 吗？不是，要用 /constexpr:depth 和 /Zc:__cplusplus
MSVC 完全不认 -ftemplate-depth，它分两层控制：
- 模板实例化深度由
/constexpr:depth控制（注意：这名字有误导性，它实际管的是 constexpr 函数递归 + 模板实例化双重深度） - 默认值是 512，比 GCC 更保守
- 必须配合
/Zc:__cplusplus（启用 C++20 标准模式），否则某些元编程构造（如std::is_same_v在别名模板中）会提前失败
常见误操作：/bigobj 是解决 OBJ 文件节超限的，和模板深度完全无关。真要调，就写：cl /constexpr:depth2000 /Zc:__cplusplus。但要注意：MSVC 对深度 > 2000 的支持不稳定，某些组合（如嵌套别名模板 + 可变参数包展开）会在 1200 层左右静默失败，不报错只卡住或崩溃。
立即学习“C++免费学习笔记（深入）”；
为什么加了 -ftemplate-depth 还报错？检查这三处
调高深度参数后仍失败，大概率不是参数没生效，而是其他机制在拦截：
- 编译器已缓存旧的预编译头（PCH）或模块接口单元（
.gch/.pcm），它们按旧深度编译过，必须清理重建 - CMake 中未将参数传给所有目标：仅在
target_compile_options()里加不够，若用了add_subdirectory()引入第三方库（如 Boost），那些子项目可能没继承该 flag - 某些 IDE（如 VS Code + CMake Tools）会缓存工具链配置，改完
CMakeLists.txt后需手动触发 “Clean Rebuild”
验证是否生效最直接的方式：在出错文件开头加一行 static_assert(__cplusplus >= 201703L, "C++17 needed");，再编译。如果报错变成模板深度不足，说明参数已起效；如果还是别的错误（比如 internal compiler error），那就是底层限制或 bug 了。
模板深度不是万能解药：替代方案比硬调参数更可靠
真正复杂的元编程（比如编译期 JSON 解析、AST 遍历、类型图遍历）靠堆深度只会让编译越来越慢、内存暴涨，甚至触发 OOM killer。
- 优先用
if constexpr替代模板递归：把逻辑分支收进单个函数模板内，避免实例化爆炸 - 把长递归拆成固定步长的“循环”：例如每 10 层用一个中间别名模板中断，降低单次实例化链
- 对
std::tuple类型操作，考虑std::apply+ lambda，而不是手写递归 unpack
最常被忽略的一点：编译器对模板参数包展开的优化能力远强于手动递归。一个 sizeof...(Ts) 能解决的问题，千万别写 20 行递归模板特化——那不是炫技，是给自己埋雷。
