Tracy 是轻量实时跨平台 C++ 性能分析器，适用于游戏开发；通过宏插入实现低开销采样，支持帧标记、内存/GPU 分析及自定义数据绘图，所有数据本地处理。
Tracy 是一个轻量、实时、跨平台的 C++ 性能分析器，特别适合游戏开发这类对低开销和高采样精度要求严苛的场景。它不依赖外部 profiler（如 VTune 或 perf），而是通过在代码中插入少量宏，将性能事件以高效二进制协议发送到独立的 Tracy GUI 进行可视化。
一、集成 Tracy 到 C++ 项目
Tracy 支持 header-only 集成，也支持编译为静态库。推荐使用 submodule 方式引入源码，便于控制版本和调试符号：
- 克隆
https://github.com/wolfpld/tracy到项目子目录（如third_party/tracy） - 在构建系统中添加
tracy/TracyClient.cpp和tracy/TracyC.cpp（若启用 C 接口）到编译列表 - 定义宏
TRACY_ENABLE（仅 Release 模式建议关闭，避免运行时开销） - 确保链接
-lpthread -ldl -lrt（Linux）或启用 WinSock（Windows）
二、标记关键代码段（Zone Profiling）
最常用的是 TracyZone 宏，用于自动记录作用域起止时间。它开销极低（约 10–20 ns），适合高频调用：
#includevoid Update() { ZoneScoped; // 自动推导函数名，等价于 ZoneNamedN(___tracy_zone, "Update", true) for (auto& obj : m_objects) { ZoneScopedN("UpdateObject"); // 自定义名称 obj.Update(); } }
也可手动控制生命周期：
立即学习“C++免费学习笔记（深入）”；
-
auto* zone = TracyZoneBegin("Loading");+TracyZoneEnd(zone); -
TracyZoneText("loaded 128 assets", 17);添加上下文字符串 -
TracyZoneColor(0xFF4488);设置火焰图颜色，方便区分模块
三、捕获帧与游戏循环对齐
游戏通常需要按“帧”组织性能视图。Tracy 提供 TracyFrameMark 宏，会在 GUI 中绘制垂直帧分隔线：
while (running) {
FrameMark; // 等价于 TracyFrameMark
HandleInput();
Update();
Render();
}搭配 TracyFrameMarkNamed("Render") 可命名帧阶段，GUI 中会显示帧率统计与各阶段耗时分布。
四、高级技巧：内存、GPU 与自定义数据
Tracy 不只做 CPU 时间采样：
-
内存分配追踪：定义
TRACY_ENABLE_MEMORY_ALLOCATION，重载new/delete或 hook malloc/free -
GPU 时间线：通过
TracyVkContext（Vulkan）、TracyD3D11Context（DX11）等绑定图形 API 的时间戳查询 -
自定义值绘图：用
TracyPlot("FPS", fps)实时绘制曲线图，支持 float/double/int64 -
线程命名：启动时调用
TracySetThreadName("RenderWorker");，GUI 中可清晰识别线程角色
启动 Tracy GUI 后，运行程序并连接（自动或手动指定 IP），即可看到实时火焰图、帧概览、调用栈、内存分配热点等。所有数据本地处理，无网络上传，符合游戏团队对隐私和延迟的要求。
