四步上手 Tracy Profiler：从集成到定位帧内卡顿-平芜编程栈

四步上手 Tracy Profiler：从集成到定位帧内卡顿

【免费下载链接】tracyFrame profiler项目地址: https://gitcode.com/GitHub_Trending/tr/tracy

你的游戏平时每帧 16 毫秒，偶尔却飙到 40 毫秒，采样式分析器只给平均值，看不到案发瞬间。Tracy Profiler 是一款实时、纳秒精度的帧分析器，用客户端-服务器架构在程序运行时低开销记录 CPU 与 GPU 活动，帮你把卡顿定位到具体函数。

你将学会

把 Tracy 接入 C++ 项目，跑通第一份帧数据
在时间线上把一个卡顿帧逐层展开到具体函数
在 GPU 时间线上对照 CPU，判断瓶颈在哪一侧
把分析数据存成文件，离线回放与对比

项目速览

Tracy 是"混合"分析器：除了像 VTune、perf 那样做调用栈采样，它更强调在代码里插入几行人工标记，逐帧记录每一次函数执行。这样才能复现"每几秒才出现一次"的偶发卡顿，而不是只看统计热点。

纳秒级分辨率：用 CPU 硬件计时器测量，单次事件录制开销仅数纳秒
以帧为单位：整个运行被切成帧，任何一帧过长都能单独放大、逐层回放
一个时间线看全维度：CPU 区域、GPU 提交、内存分配、锁等待、上下文切换同屏对照

前置准备清单

CMake ≥ 3.13；客户端代码 C++11 即可，构建 Tracy 本身建议 C++17 编译器（gcc 8+ / clang 6+ / VS2019+）
Windows / Linux / macOS 均可
无第三方依赖，克隆一个仓库就够

四步跑通最小示例

1. 克隆仓库并编译服务器

git clone https://gitcode.com/GitHub_Trending/tr/tracy cmake -S tracy -B tracy/build && cmake --build tracy/build -j cmake -S tracy/profiler -B tracy/profiler/build && cmake --build tracy/profiler/build -j

产物是tracy/profiler/build/tracy-profiler，一个独立的图形化服务器程序。

2. 写一个最小被测程序

#include <thread> #include <chrono> #include <tracy/Tracy.hpp> int main() { for (int i = 0; i < 1000; ++i) { ZoneScoped; // 把整个块标记为区域，函数退出自动结束 ZoneScopedN("模拟工作"); // 自定义区域名 std::this_thread::sleep_for(std::chrono::milliseconds(1)); FrameMark; // 帧结束标记，每帧一次 } }

3. 用 CMake 接入并编译（把 tracy 克隆在与项目同级目录）

cmake_minimum_required(VERSION 3.13) project(demo CXX) add_subdirectory(tracy) add_executable(demo main.cpp) target_link_libraries(demo Tracy::TracyClient)

4. 配置时打开总开关，运行两个程序

cmake -S . -B build -DTRACY_ENABLE=ON && cmake --build build -j ./build/demo # 被测程序 ../tracy/profiler/build/tracy-profiler

-DTRACY_ENABLE=ON必须对整个工程生效。同一台机器上两个程序会自动连接，服务器时间线立刻开始滚动。

把一个卡顿帧展开到具体函数

假设上面的程序每帧 1 毫秒，第 200 帧突然 40 毫秒。操作分三步走：

操作：运行被测程序，窗口顶部的帧栏里每个绿色条就是一帧（FrameMark切出来的）。选中那个明显变长的帧，鼠标拖选它对应的时间范围。

看到什么：中部是线程轨道，每种颜色一条线程，条状物是区域（Zone，一段被标记的函数执行）；右侧 Open 面板显示点击区域的函数名、源码行、耗时；下方 Stats 表格对选中范围按区域聚合出总耗时、平均值与占比。

怎么读懂：先看 Stats 表里占比最大的一行锁定嫌疑区域；再到时间线上找到它点击展开，一层层钻到子区域，直到看到具体函数名；鼠标悬停任何条状物会显示绝对毫秒数。三步之后，"卡了 40 毫秒"就变成了"某函数多花了 38 毫秒"。

进阶能力

把 GPU 放进同一条时间线

何时用：CPU 侧看不出来时，确认是不是 GPU 排队在拖帧。怎么用：包含对应图形 API 头文件（Vulkan/OpenGL/D3D11/12 各有），创建队列后交给 Tracy：

TracyVulkanContext ctx; TracyVulkanCollect(ctx, device, queue);

时间线会出现 GPU 轨道，CPU 区域与 GPU 提交左右对齐，等待关系一眼可见。

存盘与离线回放

何时用：偶发问题在服务器上抓不住。怎么用：运行中点工具栏的 Save 存成.tracy文件；之后任何时候用 Open 载入，逐帧回放、缩放、对比两次抓档。

源码级采样分析

何时用：想知道哪行代码吃周期，又不想再插桩。怎么用：切到 Sampling 标签页，Tracy 周期性采样调用栈，无需任何代码改动；点击热点区域可跳到源码与汇编视图，精确到单行、单条指令。

避坑速查

现象：服务器里什么都没有→ 原因：TRACY_ENABLE只在部分文件生效或未定义 → 解法：该宏必须被每个源文件看见，CMake 在配置阶段整体加-DTRACY_ENABLE=ON。
现象：区域显示 0 或耗时异常→ 原因：区域跨了线程或作用域，开闭不匹配 → 解法：单个区域必须在同线程、同作用域内开闭；跨线程逻辑拆成多个区域。
现象：客户端和服务器在不同机器，自动连接失败→ 原因：跨机依赖广播发现，容易被防火墙拦截 → 解法：在服务器 Connect 对话框里手动填客户端 IP 与默认端口 8086。
现象：担心插桩拖慢程序→ 原因：对实时性能敏感 → 解法：实时模式单事件开销仅数纳秒通常可忽略；要求更高可定义TRACY_ON_DEMAND，点服务器按钮才开录。