C++(Qt)软件调试---静态分析工具clang-tidy（18）

2024-01-23 09:36
文章标签 分析 工具 c++ qt 调试 软件 18 静态 clang tidy

本文主要是介绍C++(Qt)软件调试---静态分析工具clang-tidy（18），希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

C++(Qt)软件调试—静态分析工具clang-tidy（18）

文章目录

  • C++(Qt)软件调试---静态分析工具clang-tidy（18）
    • 1、概述
    • 2、clang-tidy基本用法
    • 3、目前已有检查项
    • 4、Qt Creator中安装clang-tidy
    • 5、Qt Creator中使用clang-tidy
    • 6、Clang-Tidy配置界面说明
    • 7、Clang-Tidy配置
    • 8、VS中使用Clang-tidy
    • 9、参考文章

更多精彩内容
👉个人内容分类汇总 👈
👉C++软件调试、异常定位 👈

1、概述

现在很多人在开发中完全忽略了编译器、IDE的警告提示，这怎么可能写出稳定的程序。

clang-tidy是一个由LLVM项目提供的开源工具，是一个静态分析工具，用于进行静态代码分析和代码质量改进。

支持C++/C/Objective-C。

clang-tidy提供了一种基于AST（抽象语法树）的检查方法，能够检测出代码中的多种潜在问题，包括内存泄漏、未使用的变量、类型不一致等。它还支持自定义检查器的创建，使得用户可以针对特定项目或代码库进行定制检查。

clang-tidy可以与Clang编译器无缝集成，这意味着开发者可以在编译过程中同时运行静态分析，以便及时发现和修复问题。此外，clang-tidy还支持与其他工具链和IDE集成，如Visual Studio、CLion、Qt等，为开发者提供便利的使用体验。

在本文中主要讲解如何在Qt、Visual Studio中使用clang-tidy。

演示环境

  • Windows11
  • Qt 6.5.3
  • Qt Creator 11.03
  • VS 2022

2、clang-tidy基本用法

  • clang-tidy.exe --help：查看帮助信息；

    在这里插入图片描述

  • clang-tidy.exe -list-checks：列出所有已启用的检查并退出；

  • clang-tidy.exe -list-checks -checks=*：列出所有可用选项。

  • clang-tidy.exe [代码文件] -checks=[检查项]：设置要运行的检查项，以逗号分隔，负号为删除检查项，没有负号为添加检查项，例如：

    • clang-tidy.exe E:\test\untitled2\main.cpp -checks=-*,clang-*表示关闭所有检查项，添加clang-组所有的检查项，检查main.cpp文件。

  • --warnings-as-errors=[检查项]：可将设置的检查项由警告升级为错误，使用如下所示

    • clang-tidy.exe E:\test\untitled2\main.cpp -checks=-*,cppcoreguidelines-* --warnings-as-errors=cppcoreguidelines-*

3、目前已有检查项

名称前缀描述
abseil-与 Abseil 库相关的检查。`
altera-与 FPGA 的 OpenCL 编程相关的检查。
android-与 Android 相关的检查。
boost-检查与 Boost 库相关的内容。
bugprone-检查是否以容易出错的代码构造为目标。
cert-与 CERT 安全编码指南相关的检查。
clang-analyzer-Clang Static Analyzer 检查。
concurrency-与并发编程相关的检查（包括 线、纤维、协程等）。
cppcoreguidelines-与 C++ 核心指南相关的检查。
darwin-与达尔文编码约定相关的检查。
fuchsia-与 Fuchsia 编码约定相关的检查。
google-与 Google 编码约定相关的检查。
hicpp-与高完整性 C++ 编码标准相关的检查。
linuxkernel-与 Linux 内核编码约定相关的检查。
llvm-与 LLVM 编码约定相关的检查。
llvmlibc-与 LLVM-libc 编码标准相关的检查。
misc-我们没有更好的类别的检查。
modernize-提倡使用现代（当前为“现代”）的检查 表示“C++11”）语言结构。
mpi-与 MPI（消息传递接口）相关的检查。
objc-检查与 Objective-C 编码约定相关的内容。
openmp-与 OpenMP API 相关的检查。
performance-检查是否针对与性能相关的问题。
portability-检查是否针对不针对可移植性相关问题 与任何特定的编码风格相关。
readability-检查是否针对与可读性相关的问题，但不针对 与任何特定的编码风格相关。
zircon-与 Zircon 内核编码约定相关的检查。

  • 列出详细检查项如下所示（未显示完全）

    在这里插入图片描述

4、Qt Creator中安装clang-tidy

  1. Qt Creator默认是安装了clang的，如果没有可以按照后面步骤进行安装。

  2. 打开Qt Creator，点击【帮助】->【关于插件】；

    在这里插入图片描述

  3. 找到【Code Analyzer】，勾选【ClangTools】，然后点击【确认】重启；

    在这里插入图片描述

  4. 打开【首选项】->【分析器】，如果出现【Clang Tools】就安装成功了。

    在这里插入图片描述

  5. Qt Creator集成了以下Clang工具，用于通过静态分析在C、C++和Objective-C源代码中发现问题：

    • Clang Tidy：它对典型的编程错误进行诊断和修复，如风格违规或接口滥用。
    • Clazy：有助于Clang理解Qt语义。它显示与Qt相关的编译器警告，从不必要的内存分配到API的误用，并具有修复某些问题的重构操作。

5、Qt Creator中使用clang-tidy

  1. 选择【工具】->【C++】->【Analyze Current File with Clang-Tidy】可使用clang-tidy分析当前打开的文件；

  2. 选择【工具】->【C++】->【Analyze Current File with Clazy】可使用Clazy分析当前打开的文件；

  3. 如下图所示，在打开的文件左侧行号位置会出现黄色三角形，说明这一行代码可能存在问题，在IDE下方会列出所有检查出的问题，双击列出的问题会定位到出现问题的行，鼠标移动到黄色三角形上会出现问题的详细说明。

    在这里插入图片描述

  4. 选择【分析】->【Clang-Tidy】/【Clazy】可以打开【Files to Analyze】窗口，可以在这个窗口中选择使用分析检查项目工程的所有文件。

    在这里插入图片描述

    在这里插入图片描述

  5. 在Clang-Tidy问题视图中如下图所示，框选出的几个按键从左到右功能如下；

    在这里插入图片描述

    1. 点击下拉框可弹出分析工具选项，选择使用哪个分析工具；

      在这里插入图片描述

    2. 使用Clang-tidy分析工程所有文件；

    3. 使用Clang-tidy分析当前打开文件；

    4. Clang-tidy在项目中的设置；

    5. 清除所有检查结果；

    6. 展开/关闭检测结果；

  6. 如下图所示，鼠标移动到黄色三角形图标上后会显示提示弹窗，右上角4个按钮功能从左到右分别是；

    1. 复制提示信息到剪贴板；
    2. 禁用检测项：clang-tidy静态分析时会出现误报情况或者某些问题不想检测时就可以点击右上角的红色×，然后点击【分析】->【clang-tidy】重新检查就可以了；（注意：如果勾选了prefer .clang-tidy file, if present则这个功能不会生效）
    3. 打开/关闭显示提示信息；
    4. 进入clang-tidy配置窗口。

    在这里插入图片描述

6、Clang-Tidy配置界面说明

  1. 打开【首选项】设置，进入【分析器】->【Clang tools】或者直接点击提示信息右上角的设置按钮；

    在这里插入图片描述

    1. diagnostic configuration：配置检查项；

    2. prefer .clang-tidy file, if present：如果工程目录下有.clang-tidy文件则优先使用.clang-tidy文件中的规则进行检查；如下图所示，在.clang-tidy文件中添加规则，然后放到工程目录下，重新运行clang-tidy检查就可以了。

      在这里插入图片描述

    3. build the project before analysis：在进行代码分析之前先构建编译，以确保要分析的代码是有效的，可以检测出更多问题。

    4. analyze open files：在打开一个文件时自动启动clang-tidy对打开的文件进行检查。

    5. parallel jobs：多线程并行启动clang-tidy检查，可以提升检查速度。

7、Clang-Tidy配置

  1. 在【Clang Tools】中点击【Default Clang-Tidy and Clazy checks】，打开窗口如下所示；

    在这里插入图片描述

  2. 这时Default Clang-Tidy and Clazy checks配置是内置配置，无法进行修改，点击【复制】重新创建一份配置就可以修改了，选择【Clang-tidy Checks】，勾选需要的检查项就可以了。

    在这里插入图片描述

  3. 选择【Clazy Checks】可配置clazy的检查级别，Clazy 检查分为从 0 到 3 的级别。级别 0 的检查非常稳定，几乎没有显示任何误报，而级别 3 的检查是实验性的。

    在这里插入图片描述

8、VS中使用Clang-tidy

从 Visual Studio 2019 版本 16.4 开始，已提供 Clang-Tidy 支持。 在 Visual Studio 安装程序中选择 C++ 工作负载时，会自动包含它。

VS中同时支持另一种代码静态检查工具【 Microsoft 代码分析】，可通过【项目】->【属性】->【Code Analysis】->【启用Microsoft Code Analysis】开启使用。

  1. 选择【项目】->【属性】;

    在这里插入图片描述

  2. 如下图所示，选择【Code Analysis】，将【生成时启用Code Analysis】设置为是，将【启用Clang-tidy】设置为是就可以在VS中启用Clang-tidy了，但是还需要配置检查项。

    在这里插入图片描述

  3. 如下图所示，选择【Clang-Tidy】，输入检查项，然后确认。

    在这里插入图片描述

  4. 然后就可以在文件修改后、编译后或者选择【分析】->【运行Code Analysis】对代码进行检查。

    在这里插入图片描述

9、参考文章

  • Clang-Tidy — Extra Clang Tools 18.0.0git documentation (llvm.org)
  • 使用 Clang 工具 |Qt Creator手册
  • 在 Visual Studio 中使用 Clang-Tidy | Microsoft Learn

{__/}
(̷ ̷´̷ ̷^̷ ̷`̷)̷◞~❤
| ⫘ |

这篇关于C++(Qt)软件调试---静态分析工具clang-tidy（18）的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/635975。

相关文章

Python实现微信自动锁定工具

Python实现微信自动锁定工具

《Python实现微信自动锁定工具》在数字化办公时代,微信已成为职场沟通的重要工具,但临时离开时忘记锁屏可能导致敏感信息泄露,下面我们就来看看如何使用Python打造一个微信自动锁定工具吧... 目录引言：当微信隐私遇到自动化守护效果展示核心功能全景图技术亮点深度解析1. 无操作检测引擎2. 微信路径智能获
阅读更多...
C#如何调用C++库

C#如何调用C++库

《C#如何调用C++库》：本文主要介绍C#如何调用C++库方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录方法一：使用P/Invoke1. 导出C++函数2. 定义P/Invoke签名3. 调用C++函数方法二：使用C++/CLI作为桥接1. 创建C++/CL
阅读更多...
Python中的Walrus运算符分析示例详解

Python中的Walrus运算符分析示例详解

《Python中的Walrus运算符分析示例详解》Python中的Walrus运算符（:=）是Python3.8引入的一个新特性,允许在表达式中同时赋值和返回值,它的核心作用是减少重复计算,提升代码简... 目录1. 在循环中避免重复计算2. 在条件判断中同时赋值变量3. 在列表推导式或字典推导式中简化逻辑
阅读更多...
Qt实现网络数据解析的方法总结

Qt实现网络数据解析的方法总结

《Qt实现网络数据解析的方法总结》在Qt中解析网络数据通常涉及接收原始字节流,并将其转换为有意义的应用层数据,这篇文章为大家介绍了详细步骤和示例,感兴趣的小伙伴可以了解下... 目录1. 网络数据接收2. 缓冲区管理（处理粘包/拆包）3. 常见数据格式解析3.1 jsON解析3.2 XML解析3.3 自定义
阅读更多...
Java中的工具类命名方法

Java中的工具类命名方法

《Java中的工具类命名方法》：本文主要介绍Java中的工具类究竟如何命名,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录Java中的工具类究竟如何命名？先来几个例子几种命名方式的比较到底如何命名 ？总结Java中的工具类究竟如何命名？先来几个例子JD
阅读更多...
利用Python调试串口的示例代码

利用Python调试串口的示例代码

《利用Python调试串口的示例代码》在嵌入式开发、物联网设备调试过程中,串口通信是最基础的调试手段本文将带你用Python+ttkbootstrap打造一款高颜值、多功能的串口调试助手,需要的可以了... 目录概述：为什么需要专业的串口调试工具项目架构设计1.1 技术栈选型1.2 关键类说明1.3 线程模
阅读更多...
C++如何通过Qt反射机制实现数据类序列化

C++如何通过Qt反射机制实现数据类序列化

《C++如何通过Qt反射机制实现数据类序列化》在C++工程中经常需要使用数据类,并对数据类进行存储、打印、调试等操作,所以本文就来聊聊C++如何通过Qt反射机制实现数据类序列化吧... 目录设计预期设计思路代码实现使用方法在 C++ 工程中经常需要使用数据类，并对数据类进行存储、打印、调试等操作。由于数据类
阅读更多...
Java程序进程起来了但是不打印日志的原因分析

Java程序进程起来了但是不打印日志的原因分析

《Java程序进程起来了但是不打印日志的原因分析》：本文主要介绍Java程序进程起来了但是不打印日志的原因分析,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Java程序进程起来了但是不打印日志的原因1、日志配置问题2、日志文件权限问题3、日志文件路径问题4、程序
阅读更多...
MySql match against工具详细用法

MySql match against工具详细用法

《MySqlmatchagainst工具详细用法》在MySQL中,MATCH……AGAINST是全文索引（Full-Textindex）的查询语法,它允许你对文本进行高效的全文搜素,支持自然语言搜... 目录一、全文索引的基本概念二、创建全文索引三、自然语言搜索四、布尔搜索五、相关性排序六、全文索引的限制七
阅读更多...
Linux下如何使用C++获取硬件信息

Linux下如何使用C++获取硬件信息

《Linux下如何使用C++获取硬件信息》这篇文章主要为大家详细介绍了如何使用C++实现获取CPU,主板,磁盘,BIOS信息等硬件信息,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下... 目录方法获取CPU信息：读取"/proc/cpuinfo"文件获取磁盘信息：读取"/proc/diskstats"文
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2