必须加 -fsanitize=thread 且禁用优化，因 TSan 依赖编译插桩检测数据竞争，-O2+ 会优化掉竞争痕迹，-O0/-O1 加 -fno-inline 才能准确追踪；链接时需重复 -fsanitize=thread 和 -pthread。
为什么编译时必须加 -fsanitize=thread 且禁用优化
ThreadSanitizer 不是运行时库或独立工具，它依赖编译器在插桩阶段注入内存访问检查逻辑。不加 -fsanitize=thread 就完全没检测能力；而开启 -O2 或更高优化后，编译器可能合并、重排或消除看似冗余的读写操作，导致真实的数据竞争被掩盖，TSan 报告变少甚至为零。
必须搭配 -O1（最低可用优化）或 -O0（推荐），同时禁用内联：-fno-inline —— 否则函数内联会让 TSan 无法准确追踪跨函数的共享变量访问链。
链接时不能漏掉 -fsanitize=thread 和 -pthread
即使编译用了 TSan，链接阶段若没重复指定 -fsanitize=thread，会报类似 undefined reference to __tsan_init 的错误；而 -pthread 不只是“支持线程”，它影响符号解析和线程局部存储（TLS）行为，缺失会导致 TSan 初始化失败或漏检锁相关逻辑。
完整命令示例：
g++ -O0 -g -fsanitize=thread -fno-inline main.cpp -o main -fsanitize=thread -pthread
注意：两个 -fsanitize=thread 缺一不可（编译和链接各一次），-pthread 必须出现在链接参数末尾附近。
遇到 WARNING: ThreadSanitizer: data race 怎么看报告
TSan 报告不是只给一行错误，而是分块展示：竞争发生的**两个线程栈** + **冲突变量地址/名称** + **读写类型（READ vs WRITE）** + **所在源码行号**。关键点：
立即学习“C++免费学习笔记（深入）”；
- 先确认
Location行是否指向你自己的代码（而非 std::mutex 或系统调用），避免误判底层实现问题 - 注意两个栈帧中是否有共同的共享变量（比如全局
int counter或类成员），TSan 不会自动命名变量，需靠地址和上下文反推 - 如果报告里出现
Previous write和Current read但变量明显只读（如 const 成员），可能是 const_cast 或内存重解释导致，需检查强制类型转换 - 忽略
Thread T1 (tid=123, finished)这类提示——它只是说明该线程已退出，不代表竞争不成立
常见漏检场景和绕过限制的方法
TSan 有天然盲区：它只监控通过编译器插桩覆盖的内存访问，对以下情况无能为力：
- 直接系统调用（如
write(),mmap()）绕过 C++ 运行时的内存操作 - 使用
std::atomic且未用memory_order_relaxed以外的序——TSan 默认信任 atomic 操作的同步语义，不会检查其内部 - 通过
memcpy、memset修改共享内存，除非加-fsanitize=thread -fno-builtin-memcpy强制插桩（性能代价大，慎用） - 静态初始化期间的竞争（如全局对象构造函数中的多线程访问）——TSan 在
main()之前尚未就绪
若怀疑这些场景有问题，得配合 valgrind --tool=helgrind 或手动加锁审计，不能只信 TSan 报告为空。
