使用 Tracy 进行 C++ 游戏开发中的帧级别性能剖析，是一种高效、轻量且可视化程度高的方式。Tracy 是一个实时的性能分析器（profiler），支持高精度计时、帧级追踪、内存分配监控以及线程行为观察，特别适合用于游戏引擎或实时应用中进行逐帧性能调优。

1. 集成 Tracy Profiler 到 C++ 项目

步骤一：获取 Tracy 源码
从 Tracy 的官方仓库（https://github.com/wolfpld/tracy）下载源代码，主要需要以下两个文件：

• TracyClient.cpp
• tracy/Tracy.hpp

将它们添加到你的 C++ 项目中，并确保编译时启用 C++11 或更高版本。

步骤二：编译选项设置
为了获得最佳性能数据，建议在 Release 模式下开启调试信息（如 GCC/Clang 使用 -g），以便 Tracy 显示准确的源码位置。

• GCC/Clang: 添加 -g -DTRACY_ENABLE
• MSVC: 添加 /D TRACY_ENABLE 并启用调试信息

注意：TRACY_ENABLE 宏必须定义，否则所有 Tracy 调用都会被忽略。

步骤三：链接必要的系统库
Tracy 使用 socket 和线程功能，在 Linux 上可能需要手动链接：

• -lpthread
• -lssl 和 -lcrypto（如果启用了加密连接）

2. 在游戏中插入帧级性能标记

Tracy 的核心是“区域”（Zone），你可以用它来标记函数、循环或任意代码段。

立即学习“C++免费学习笔记（深入）”；

基础 Zone 示例

#include <tracy/Tracy.hpp>

void UpdateGameLogic() {
    ZoneScoped; // 自动命名为此函数名
    // 逻辑更新代码
}

如果你想自定义名称：

void RenderFrame() {
    ZoneNamedN(renderZone, "渲染主循环");
    // 渲染逻辑
}

帧边界标记
要在帧级别进行分析，推荐在每一帧开始处打上帧标记：

void GameLoop() {
    while (running) {
        FrameMark; // 标记新帧的开始

        UpdateGameLogic();
        RenderFrame();
    }
}

使用 FrameMark 后，Tracy 会自动识别帧边界，可在 UI 中按帧查看各区域耗时分布。

Powerful AI-powered animation tool and image-to-video AI generator.

3. 分析多线程与细粒度区域

现代游戏通常使用多线程，Tracy 支持跨线程追踪。

命名线程

#include <tracy/TracyC.h>

std::thread worker([]{
    tracy::SetThreadName("资源加载线程");
    // 工作内容
});

嵌套 Zone 示例

void DrawScene() {
    ZoneScoped;
    for (auto& obj : objects) {
        ZoneNamedN(drawObj, "绘制对象");
        TracyPlot("对象数量", objects.size());
        DrawOneObject(obj);
        ZoneEnd(drawObj); // 显式结束
    }
}

嵌套结构会在 Tracy UI 中清晰展示调用层次和时间占比。

4. 启动 Tracy Collector 并查看分析结果

运行服务端
下载并运行 Tracy 的官方 Profiler（GUI 程序），启动后默认监听 8086 端口。

运行你的游戏程序
确保程序能连接到本机或指定 IP 的 Tracy 服务端。若跨设备分析（如主机或移动端），需设置环境变量或代码中指定地址：

tracy::StartupSampling(); // 可选：开启采样模式
setenv("TRACY_ADDRESS", "192.168.1.100:8086", 1); // Linux/macOS
// 或在 Windows 使用 _putenv_s

实时查看帧性能
在 Tracy UI 中你会看到：

• 每帧的时间轴（通过 FrameMark 划分）
• 各线程上的 Zone 分布
• 函数耗时热点统计
• 可点击进入具体帧，查看该帧内所有操作的执行顺序和耗时

你还可以使用 TracyPlot 绘制数值趋势，例如 FPS、对象数量等：

TracyPlot("FPS", current_fps);

这些数据会以曲线形式显示在时间轴下方，便于关联性能波动原因。

基本上就这些。集成一次后，后续只需在关键路径加 Zone 和 FrameMark，就能持续监控帧级表现。不复杂但容易忽略的是：确保 Release 版本也包含 Tracy 数据输出，并合理控制日志量避免影响性能本身。