llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

Constexpr 调试器

Constexpr 调试器可让您深入了解编译时求值,尤其是 constexpr 和 consteval 代码。 它可以让您停留在编译器的世界中,准确查看求值期间发生的情况。

目前可以使用 Constexpr 调试器执行以下操作:

  • 通过点击 调试 按钮(该按钮位于 static_assert(...) 或 constexpr 声明符旁),从装订区域启动逐步调试,以检查其求值方式或失败原因。

  • 使用与常规调试器中 相同的操作 ,例如 单步进入 或 单步跳过。 此外,还可以使用 后退一步},{ ,这是编译时反向步进功能。

  • 查看编译器看到的内容:当前实例化的调用堆栈、局部变量、最近返回值和模板实参。

  • 将鼠标悬停在变量上以查看其值,使用 计算表达式 ,或从调用堆栈导航到源代码。

  • 在常量求值失败时检查整个上下文,以确定失败发生的时间和原因。

主要调试功能

以下各节概述了调试 constexpr 代码时可以执行的基本操作。

开始调试

作为代码示例,我们来看一下这个编译时 Fibonacci 缓存的实现:

#include <array> template<std::size_t N> struct FibCache { std::array<int, N + 1> memo{}; constexpr FibCache() { memo[0] = 0; memo[1] = 1; for (std::size_t i = 2; i <= N; ++i) memo[i] = memo[i - 1] + memo[i - 2]; } constexpr int operator()(int n) const { return memo[n]; } }; constexpr int get_fibonacci(int n) { FibCache<8> cache; auto result = cache(n); return result; } constexpr int k = get_fibonacci(6); static_assert(get_fibonacci(6) == 8, "ok");
  1. 点击 图标,该图标位于 constexpr 声明符或 static_assert 旁边,以开始调试:

    开始调试
  2. 使用标准 单步进入 或 单步跳过 调试器操作来对表达式求值:

    单步进入
  3. 使用 后退一步},{ 回退浏览编译时求值的每个步骤:

    后退一步
  4. 检查状态:

    • 在编辑器中将鼠标悬停在 this->memo 上,查看数组在构造期间如何填充:

      检查 memo
    • 按 Alt+F8 对表达式或类型求值:

      计算表达式
    • 检查 线程与变量 窗格以查看 this 、像 i 这样的局部变量以及最近的返回值:

      检查变量
    • 使用 帧 窗格查看调用堆栈并导航到源代码:

      检查调用堆栈
  5. 在构造函数预计算所有 Fibonacci 数后,在 线程与变量 窗格中检查结果:

    检查结果

诊断并修复编译时错误

  • 当求值失败时,例如由于代码逻辑不正确,CLion 会高亮显示错误。 将鼠标悬停在错误上时,会出现一个包含问题说明的弹出窗口:

    错误弹出窗口

    如果仍不清楚导致错误的原因以及错误发生在哪个步骤,请点击 运行求值直到失败 进行调试。 Constexpr 调试器会在失败的求值处停止,并显示错误消息和上下文。

  • 当表达式无法在编译时求值时(例如调用了非 constexpr 函数),CLion 会在编辑器和调试期间高亮显示错误:

    非 constexpr 求值

    限制

    • constexpr 求值不支持断点和 运行到光标处 / 强制运行到光标处。

    • 我们的 constexpr 求值器尚不支持某些构造。 可以在 YouTrack 上跟踪进展并为相关问题投票。

    2026年 11月 6日