讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

剧云
剧云

中文短剧剧本制作平台

如何使用 sanitizers-cmake 简化c++项目的内存和线程问题检测? (CMake集成)

胖磊姑娘_5524

胖磊姑娘_5524

发布时间:2026-01-13 15:59:03

|

926人浏览过

|

来源于php中文网

原创

sanitizers-cmake 是一个轻量级 CMake 脚本集合,用于自动启用 Clang/GCC 的 Address/Thread/UndefinedBehaviorSanitizer,解决手动配置易漏、优化冲突、Release 下链接失败等问题。

如何使用 sanitizers-cmake 简化c++项目的内存和线程问题检测? (cmake集成)

什么是 sanitizers-cmake,它能解决什么问题

sanitizers-cmake 是一个轻量级 CMake 脚本集合,用于在构建时自动启用 Clang/GCC 的 AddressSanitizer、ThreadSanitizer、UndefinedBehaviorSanitizer 等检测器。它不替代 sanitizer 本身,而是帮你绕过手动配置编译选项的繁琐过程——比如避免漏加 -fsanitize=address、忘记禁用优化、或在 Release 模式下误启 sanitizer 导致链接失败。

如何在 CMakeLists.txt 中集成 sanitizers-cmake

最简集成方式是通过 FetchContent 动态拉取并启用所需 sanitizer。注意:必须在 project() 之后、add_executable() 或 add_library() 之前调用配置逻辑。

  • 确保你的 CMake 版本 ≥ 3.14(FetchContent 稳定支持)
  • Clang ≥ 6.0 或 GCC ≥ 8.0 才具备完整 sanitizer 支持;GCC 的 ThreadSanitizer 对 C++17 std::shared_mutex 等有已知限制
  • 不要在 CMAKE_BUILD_TYPE=Release 下启用 sanitizer——它们依赖调试信息和未优化代码,否则会触发 undefined reference to __asan_init 类链接错误
include(FetchContent)
FetchContent_Declare(
  sanitizers_cmake
  GIT_REPOSITORY https://github.com/arsenm/sanitizers-cmake.git
  GIT_TAG        v1.2.0
)
FetchContent_MakeAvailable(sanitizers_cmake)
<h1>启用 AddressSanitizer + UndefinedBehaviorSanitizer</h1><p>setup_sanitizers(ADDRESS UNDEFINED)</p><h1>可选:单独启用 ThreadSanitizer(注意:仅支持 Clang,且需链接 -lpthread)</h1><h1>setup_sanitizers(THREAD)</h1>

常见构建失败原因与修复方式

启用后编译失败,大概率不是脚本问题,而是环境或项目配置冲突:

git-push
git-push

自动用 git 提交代码并推送到远程仓库。当用户输入 `/gitpush` 时触发此技能。功能包括:自动暂存所有更改、自动生成提交信息、自动提交到本地仓库、自动推送到远程分支。成功后报告提交状态、文件数量和耗时。

下载

立即学习“C++免费学习笔记(深入)”;

  • undefined reference to __tsan_init:说明链接时没带 -fsanitize=thread,检查是否只在 CXX_FLAGS 加了 flag 却没同步到链接器——setup_sanitizers() 内部已处理,但若你手动覆盖了 CMAKE_EXE_LINKER_FLAGS 就会失效
  • 使用 find_package(Threads) 后仍报线程相关 undefined symbol:Clang 的 TSan 要求所有目标都统一启用,包括依赖的静态库;若某个子目录没调用 setup_sanitizers(),就会断链
  • 运行时报 ERROR: ThreadSanitizer: failed to intercept 'malloc':通常是动态加载了未插桩的第三方 .so(如某些 GPU 驱动库),需用 TSAN_OPTIONS="ignore_noninstrumented_modules=1" 临时绕过
  • Windows 上无法使用:sanitizers-cmake 仅支持 Linux/macOS;MSVC 完全不支持 ASan/TSan,Clang-CL 方式也受限

为什么不能把 sanitizer 当成 CI 中的“兜底测试”

sanitizer 是编译期注入的运行时检测,它只覆盖实际执行到的代码路径。这意味着:

  • 没被单元测试调用的分支、异常路径、初始化逻辑,不会触发 ASan 报告内存泄漏或越界
  • TSan 的数据竞争检测依赖线程调度时机,一次通过 ≠ 无竞争;需配合 TSAN_OPTIONS="second_deadlock_timeout=1" 增加压力
  • UBSan 对 std::vector::at() 越界默认静默,需显式开启 -fsanitize=undefined -fno-sanitize-recover=undefined 才中止进程
  • 生产环境绝对禁止启用——性能损耗达 2–3 倍,内存占用翻倍,且部分 sanitizer(如 MSan)要求全链路(包括 libc)重编译

真正有效的做法是:在 CI 中为每个 PR 构建一个 Sanitize 构建类型,跑完全部单元测试 + 关键集成路径,并把 ASAN_OPTIONS=detect_leaks=1 写进环境变量——否则 ASan 默认关闭泄漏检测。

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1089

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3560

2023.10.25

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

4918

2023.08.10

Java 并发编程高级实践
Java 并发编程高级实践

本专题深入讲解 Java 在高并发开发中的核心技术,涵盖线程模型、Thread 与 Runnable、Lock 与 synchronized、原子类、并发容器、线程池(Executor 框架)、阻塞队列、并发工具类(CountDownLatch、Semaphore)、以及高并发系统设计中的关键策略。通过实战案例帮助学习者全面掌握构建高性能并发应用的工程能力。

603

2025.12.01

undefined是什么
undefined是什么

undefined是代表一个值或变量不存在或未定义的状态。它可以作为默认值来判断一个变量是否已经被赋值,也可以用于设置默认参数值。尽管在不同的编程语言中,undefined可能具有不同的含义和用法,但理解undefined的概念可以帮助我们更好地理解和编写程序。本专题为大家提供undefined相关的各种文章、以及下载和课程。

12385

2023.07.31

网页undefined是什么意思
网页undefined是什么意思

网页undefined是指页面出现了未知错误的意思,提示undefined一般是在开发网站的时候定义不正确或是转换不正确,或是找不到定义才会提示undefined未定义这个错误。想了解更多的相关内容,可以阅读本专题下面的文章。

5547

2024.08.14

网页undefined啥意思
网页undefined啥意思

本专题整合了undefined相关内容,阅读下面的文章了解更多详细内容。后续继续更新。

2516

2025.12.25

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3499

2023.07.26

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

100

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn