Tracy 性能分析器快速上手指南三平台从零到跑通帧剖析的完整清单【免费下载链接】tracyFrame profiler项目地址: https://gitcode.com/GitHub_Trending/tr/tracy做完这篇文章里的步骤你可以在 Windows、Linux 或 macOS 上编译出 Tracy 性能分析器Profiler的图形界面并用一个自带示例程序把真实帧数据送进时间线里看到结果。Tracy 是一款实时、纳米级分辨率的远程遥测帧分析器支持 CPU 与 GPU 剖析、内存分配追踪和锁竞争检测C/C/Lua/Python 等语言均可接入。项目速览它把帧剖析变成看时间线Tracy 的用法是在你的程序里加几个宏比如ZoneScoped程序运行时把事件通过网络发给分析器进程分析器把每个函数调用画成一条带颜色的横条。它解决的核心问题是这一帧的 16ms 到底花在哪了——CPU 侧的函数耗时、GPU 侧的 API 命令OpenGL、Vulkan、D3D、Metal、CUDA 等、内存分配、锁等待都能同屏对照。下面这张就是 Tracy 分析器的主时间线视图左侧是多线程帧带下方是逐函数的耗时统计开工前先确认这几样工具三个平台的差异集中在依赖包这一个点上工具链大同小异一张表就够了项目WindowsLinuxmacOS编译器Visual Studio 2019 或 MinGWGCC 8 或 ClangXcode 11构建系统CMake 3.25分析器 GUI 的要求同左同左图形窗口库由 CMake 自动拉取libglfw3-dev可选wayland-develglfw字体渲染自动libfreetype6-dev自动包管理器命令无sudo apt-get install build-essential cmake libglfw3-dev libfreetype6-devbrew install cmake glfw依赖清单可以从根目录 CMakeLists.txt 和 cmake/vendor.cmake 中溯源构建开关全部集中在 cmake/options.cmake编译时想关掉哪个功能都有对应的TRACY_*选项。一条命令先跑起来最小化编译路径你只需要四步先拿 Linux 为例Windows/macOS 的差异在下面一节的表里补齐git clone https://gitcode.com/GitHub_Trending/tr/tracy cd tracy cmake -B build -S profiler -DCMAKE_BUILD_TYPERelease cmake --build build -j$(nproc)这一步之后build/目录里就会出现分析器可执行文件Linux 下名为TracyWindows 下为Tracy.exe。先别急着跑示例直接双击它看到欢迎界面就算编译成功——它是独立的图形程序启动时不依赖任何被剖析的目标。注意分析器 GUI 是一个独立的 CMake 工程入口在 profiler/CMakeLists.txt需要 CMake 3.25 和 C20 编译器仓库根目录的 CMake 工程只负责产出接入你项目的 TracyClient 库。三平台差异对照动作WindowsLinuxmacOS生成工程cmake -B build -S profiler -G Visual Studio 16 2019 -A x64cmake -B build -S profiler -DCMAKE_BUILD_TYPEReleasecmake -B build -S profiler -G Xcode然后open build或用 ⌘B 编译编译在 VS 里对 ALL_BUILD 执行生成cmake --build build -j$(nproc)同上启动分析器build\Release\Tracy.exe./build/Tracy./build/Tracy额外注意需要对应版本 Windows SDKMinGW 用户由构建脚本自动补链ws2_32等库默认走 X11想要 Wayland 可按官方手册配置想用 .app 打包可开BUNDLE选项产物位置build\Release\build/build/如何确认装好了用官方示例做一次端到端验证编译出Tracy不等于能分析真正的标志是运行一个带埋点的程序分析器自动发现并连上它时间线上出现帧。仓库自带一个最小示例 examples/fibers.cpp单文件即可编译Linux 命令如下注意-DTRACY_FIBERS是示例本身需要的宏g -O2 -stdc11 -DTRACY_ENABLE -DTRACY_FIBERS1 -Ipublic examples/fibers.cpp public/TracyClient.cpp -o fibers -lpthread接着按这个顺序先启动分析器./build/Tracy再启动./fibers。Tracy 会通过网络广播自动发现客户端并连接你会看到窗口从等待连接变为填充了彩色帧带。如果一切正常CPU Data 标签页里还能看到逐函数的耗时、内存分配、消息和 CPU 占用这类统计长这样连接上的判定依据是时间线右上角出现客户端信息且帧条开始滚动fibers退出后分析器进入断开的灰色状态说明整条链路客户端埋点 → 网络传输 → 分析器渲染都通了。卡点速查现象 → 原因 → 处理现象可能原因处理CMake 报错版本不足分析器工程要求 3.25根工程 3.13升级 CMake 到 3.25 以上cmake --version确认链接阶段报找不到 glfwLinux 没装图形窗口库sudo apt-get install libglfw3-devmacOS 用brew install glfw分析器启动后闪退/黑屏显卡驱动不支持 OpenGL 3.3更新显卡驱动虚拟机环境换宿主机验证启动界面正常但连不上客户端防火墙拦截 8086 端口或广播被禁放行本机 8086 端口或启动fibers时手动指定分析器 IP界面里中文/符号显示异常内置字体不含对应字形检查 profiler/src/font/ 下的字体文件是否完整编译极慢或卡在下载依赖GUI 工程通过 CPM 拉取第三方库保证网络可达依赖管理逻辑见 cmake/CPM.cmake想少装系统依赖文件选择框依赖 GTK/xdg-portal配置时开NO_FILESELECTOR选项代价是失去打开存档文件功能延伸方向接下来去看什么官方手册Markdown 版manual/tracy.md涵盖接入宏、编译选项和构建细节的完整说明更多示例examples/ 目录下有 ToyPathTracer、dyna 小游戏、OpenGL/WebGPU 三角形等可直接对照学习的项目版本动态NEWS 记录了每个版本的改动客户端与分析器必须版本一致升级前先读它【免费下载链接】tracyFrame profiler项目地址: https://gitcode.com/GitHub_Trending/tr/tracy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考