如何快速上手ThreadRace:从零编译到跑通第一个并发基准的完整指南
如何快速上手ThreadRace:从零编译到跑通第一个并发基准的完整指南
ThreadRace 是一个 C++ 并发遥测(Concurrency Telemetry)框架,用来量化"并行到底快了多少":它把同一个 Ackermann 基准任务分别交给单线程顺序执行和多线程并行执行两种策略,再用纳秒级高精度的 std::chrono 时钟记录耗时,输出 Real / User / System / CPU% 等性能遥测数据。本文带你从零开始,完成安装依赖 → 一键编译 → 跑通第一个并发基准 → 打开 60FPS 可视化竞速场景的全部流程。
ThreadRace 是什么:30 秒看懂核心功能
简单来说,ThreadRace 回答一个很直观的问题:同样一�儿计算,拆给多个线程跑,真的更快吗?快多少?
它内置三个核心角色(详见 docs/architecture.md):
| 角色 | 作用 | 源码位置 |
|---|---|---|
| ITask | 基准任务接口,内置 AckermannTask(高复杂度递归计算) | include/core/ITask.hpp |
| IExecutionStrategy | 执行策略接口:Sequential(顺序)/ Threaded(多线程) | include/core/IExecutionStrategy.hpp |
| Benchmarker | 遥测计时器,负责计时与性能报告 | src/Benchmarker.cpp |
选择 Ackermann 函数作为基准任务,是因为它是典型的深度递归、CPU 密集型运算——最能暴露多线程同步与调度的优劣。
环境准备:安装 ThreadRace 编译依赖(一键命令)
ThreadRace 要求 POSIX 环境(Linux / WSL2 / macOS)与 C++11。核心基准程序只依赖 g++ 和 make;若要编译可视化器,还需 SDL2 与 OpenGL 开发库。
1️⃣ 获取源码
git clone https://gitcode.com/gh_mirrors/th/ThreadRace
cd ThreadRace
2️⃣ 安装系统依赖(按发行版三选一,完整说明见 docs/development.md)
# Ubuntu / Debian
sudo apt-get update
sudo apt-get install -y build-essential g++ make libsdl2-dev libgl1-mesa-dev
# Arch Linux
sudo pacman -S base-devel gcc make sdl2 mesa
# Fedora / RHEL
sudo dnf install gcc-c++ make SDL2-devel mesa-libGL-devel
💡 提示:如果你只想跑命令行基准测试,装好
g+++make即可,SDL2 可留到后面再补。
最快编译方法:make all 一次生成两个程序
项目使用标准 POSIX Makefile 管理构建,-O2 生产级优化 + -pthread 线程支持已配置完毕,无需任何手工设置:
make all
编译完成后,bin/ 目录下会生成两个可执行文件:
| 命令 | 产物 | 用途 |
|---|---|---|
make all / make |
bin/time_tester |
CLI 并发基准测试 + 遥测报告 |
make all |
bin/ackermann_visualizer |
60 FPS 硬件加速可视化器(SDL2 + OpenGL) |
make test |
— | 顺序/多线程回归测试一键验证 |
make clean |
— | 清理 obj/ 与 bin/ 构建产物 |
跑通第一个并发基准:time_tester 命令行用法
time_tester 的用法非常直白:./bin/time_tester <模式> <a href="https://link.gitcode.com/i/0233ea3767010f084ae0fdd21adf96b7" target="_blank">迭代次数](入口逻辑见 [src/main.cpp)。
| 命令 | 执行模型 | 说明 |
|---|---|---|
./bin/time_tester 1 |
Sequential(顺序) | 任务在单线程中依次执行 |
./bin/time_tester 2 |
Threaded(多线程) | 任务拆给多个 std::thread 并发执行 |
./bin/time_tester 2 5 |
Threaded,5 次迭代 | 第三个参数自定义迭代次数(默认 3) |
先跑顺序模式,再跑多线程模式:
./bin/time_tester 1
./bin/time_tester 2 5
跑完后终端会输出每轮及总体的 Real(实际耗时)、User(用户态)、System(内核态)、CPU% 等遥测指标。对比两次结果,你就能直观看到并行策略在这台机器上省下了多少时间。🎉
📌 功能自检点:Ackermann(4, 1) 的计算结果必须是 65533,如果输出一致,说明基准链路完全正常(任务实现见 src/tasks/AckermannTask.cpp)。
进阶玩法:打开 4 种 60FPS 可视化竞速模式
命令行看数字,眼睛看画面。运行可视化器(参数为 Ackermann 的 m、n 值):
./bin/ackermann_visualizer 3 3
按数字键 1~4 即可在四种渲染模式间切换,下面是完整效果图。
模式 1:Quantum 分支树 —— 递归调用栈被渲染成发光的 OpenGL 节点树,贝塞尔曲线连接分支,递归到底时迸发粒子星爆:
模式 2:3D 对数地形 —— 把 Ackermann 增长量 经过双重对数压缩后映射为 3D 地形高度图:
模式 3:黄金螺旋轨道 —— 调用栈深度与帧步数映射到黄金比例 φ 粒子星系,配合实时五声音阶合成音效(按 M 键开关):
模式 4:Thread Race 竞技场(即文首那张图)—— 单线程 vs 多线程正面对抗,实时显示进度条、内存占用、加速比与冲线判定,是理解 ThreadRace 核心理念的最佳入口。
常用操作速查(完整说明见 README.md):
SPACE/P:播放 / 暂停模拟S:暂停时单步推进[/]、-/+:调整 m / n 参数I/O:镜头缩放;鼠标拖拽平移R:重置;H:开关 HUD 信息层;ESC/Q:退出
常见问题排查清单
| 症状 | 原因与解法 |
|---|---|
make: command not found |
未安装 make,按上文安装对应发行版依赖包 |
链接 ackermann_visualizer 时报 SDL2 / GL 缺失 |
缺 libsdl2-dev、libgl1-mesa-dev,补齐后再 make all |
Error: Invalid mode 3 |
模式只支持 1(顺序)或 2(多线程),迭代次数才是第三个参数 |
| 顺序模式结果 ≠ 65533 | 检查是否用 make all 完整重编译过,可先 make clean 再构建 |
| 可视化窗口打不开(无显示器环境) | 服务器无 GPU/显示环境属正常现象,仅影响可视化器,time_tester 不受影响 |
写在最后
到这里,你已经完整走通了 ThreadRace 的核心链路:克隆源码 → 安装依赖 → make all 编译 → 用 time_tester 对比顺序与多线程的并发基准遥测 → 用 ackermann_visualizer 直观感受线程竞速。如果想深入架构设计,可以继续阅读 docs/architecture.md;想参与贡献,参考 CONTRIBUTING.md 即可。



