C++ UndefinedBehaviorSanitizer (UBSan)怎么用

老磊大大_3282

老磊大大_3282

2026-10-08

967人浏览

原创

ubsan编译时必须加-fsanitize=undefined,否则其他配置无效;它是编译期插桩工具,需配合-fno-omit-frame-pointer、-g和-o2(避免-o3),clang命令相同,msvc不支持。

c++ undefinedbehaviorsanitizer (ubsan)怎么用

UBSan 编译时必须加 -fsanitize=undefined

不加这个 flag,其他所有配置都无效。UBSan 是编译期注入检测逻辑的工具,不是运行时动态加载的库。常见错误是只加了 -fsanitize=address 或漏掉 -fno-omit-frame-pointer,导致部分检查(比如移位越界、返回未初始化值)静默失效。

推荐基础编译命令:

g++ -fsanitize=undefined -fno-omit-frame-pointer -g -O2 main.cpp -o main
  • -g 必须带上,否则报错时看不到源码行号
  • -O2 可以保留(UBSan 在优化后仍有效),但避免用 -O3 中某些激进优化(如循环展开可能掩盖未定义行为的触发路径)
  • Clang 也支持,命令完全一致;MSVC 不支持 UBSan,别白费劲

运行时报 runtime error: member call on address XXXX which is not aligned 怎么办

这是典型的内存对齐违规,常见于 reinterpret_cast 强转或 packed struct 成员访问。UBSan 在 x86_64 上严格检查 int64_t、double 等类型是否按 8 字节对齐。

实操建议:

  • 检查是否用了 #pragma pack(1) 或 __attribute__((packed)),并在访问对齐敏感字段前手动 memcpy 到对齐变量
  • 避免直接 reinterpret_cast<int64_t>(buf + offset)</int64_t>,改用 std::memcpy(&val, buf + offset, sizeof(val))
  • 若必须用指针解引用,加 -fsanitize=undefined -fsanitize-align(GCC 12+/Clang 14+)显式启用对齐检查,方便定位

为什么 int x = 1 没报错?

UBSan 默认不开启所有子检查项。左移位数 ≥ 类型宽度属于「shift」类未定义行为,但需要显式启用:

C++ Code Review Master
C++ Code Review Master

组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载
g++ -fsanitize=undefined -fsanitize=shift -g main.cpp

常用子检查项还有:

  • -fsanitize=integer-divide-by-zero:除零(默认开启)
  • -fsanitize=signed-integer-overflow:有符号溢出(默认开启)
  • -fsanitize=null:空指针解引用(默认开启)
  • -fsanitize=vla-bound:变长数组越界(需额外加)

完整列表查 gcc -fsanitize=help,但别全开——部分检查(如 float-cast-overflow)会显著拖慢运行速度。

和 AddressSanitizer(ASan)一起用要注意什么

可以共存,但顺序和链接方式很关键。UBSan 和 ASan 共享部分运行时库,混用时容易符号冲突或漏检。

正确做法:

  • 统一用同一套 sanitizer 运行时:同时加 -fsanitize=address,undefined,而不是分两次编译
  • 避免单独链接 libubsan.a 或 libasan.a,让编译器自动选兼容版本
  • 若程序用 dlopen 加载插件,UBSan 对插件内未定义行为默认不检测——得在插件编译时也加相同 flag

最易忽略的是信号处理:UBSan 错误默认调用 abort(),而 ASan 有时会安装自己的 signal handler。如果代码里 catch 了 SIGABRT,可能掩盖真实错误位置。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

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

下载

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

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2228

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

999

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

407

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

307

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

386

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

580

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1389

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1197

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Conan 2 Essentials 免费课程
Conan 2 Essentials 免费课程

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 高级依赖模型介绍
Conan 2 高级依赖模型介绍

共0课时 | 0人学习