当前位置： 首页 > news >正文

gtest框架的安装与使用

news 2025/7/31 9:24:19

1、介绍

GTest 是一个跨平台的 C++单元测试框架，由 google 公司发布。gtest 是为了在不同 平台上为编写 C++单元测试而生成的。它提供了丰富的断言、致命和非致命判断、参数化等等测试所需的宏，以及全局测试，单元测试组件。

2、安装

sudo apt-get install libgtest-dev

3、使用

头文件的包含

#include <gtest/gtest.h>

框架初始化接口

testing::InitGoogleTest(&argc, argv);

调用测试样例

RUN_ALL_TESTS();

TEST宏

//这里不需要双引号，且同测试下多个测试样例不能同名

TEST(测试名称, 测试样例名称)

TEST_F(test_fixture,test_name)

  • TEST：主要用来创建一个简单测试， 它定义了一个测试函数， 在这个函数中可以使用任何 C++代码并且使用框架提供的断言进行检查
  • TEST_F：主要用来进行多样测试，适用于多个测试场景如果需要相同的数据配置的情况， 即相同的数据测不同的行为

断言宏

GTest 中的断言的宏可以分为两类：
  • ASSERT_系列：如果当前点检测失败则退出当前函数
  • EXPECT_系列：如果当前点检测失败则继续往下执行
下面是经常使用的断言介绍

// bool 值检查

ASSERT_TRUE(参数)，期待结果是 true

ASSERT_FALSE(参数)，期待结果是 false

//数值型数据检查

ASSERT_EQ(参数 1，参数 2)，传入的是需要比较的两个数 equal

ASSERT_NE(参数 1，参数 2)，not equal，不等于才返回 true

ASSERT_LT(参数 1，参数 2)，less than，小于才返回 true

ASSERT_GT(参数 1，参数 2)，greater than，大于才返回 true

ASSERT_LE(参数 1，参数 2)，less equal，小于等于才返回 true

ASSERT_GE(参数 1，参数 2)，greater equal，大于等于才返回 true

样例

main.cc

#include <gtest/gtest.h>int abs(int x)
{return x > 0 ? x : -x;
}TEST(abs_test, test1)
{ASSERT_TRUE(abs(1) == 1) << "abs(1)=1";ASSERT_TRUE(abs(-1) == 1);ASSERT_FALSE(abs(-2) == -2);ASSERT_EQ(abs(1),abs(-1));ASSERT_NE(abs(-1),0);ASSERT_LT(abs(-1),2);ASSERT_GT(abs(-1),0);ASSERT_LE(abs(-1),2);ASSERT_GE(abs(-1),0);
}int main(int argc, char* argv[])
{//单元测试框架的初始化testing::InitGoogleTest(&argc, argv);//开始所有的单元测试return RUN_ALL_TESTS();
}

makefile

main: main.ccg++ -std=c++17 $^ -o $@ -lgtest

运行结果

事件机制

GTest 中的事件机制是指在测试前和测试后提供给用户自行添加操作的机制，而且该机制也可以让同一测试套件下的测试用例共享数据。GTest 框架中事件的结构层次：

测试程序：一个测试程序只有一个 main 函数，也可以说是一个可执行程序是一个测试程序。该级别的事件机制是在程序的开始和结束执行

  • 测试套件：代表一个测试用例的集合体，该级别的事件机制是在整体的测试案例开始和结束执行
  • 测试用例：该级别的事件机制是在每个测试用例开始和结束都执行

事件机制的最大好处就是能够为我们各个测试用例提前准备好测试环境，并在测试完毕后用于销毁环境，这样有个好处就是如果我们有一端代码需要进行多种不同方法的测试，则可以通过测试机制在每个测试用例进行之前初始化测试环境和数据，并在测试完毕后清理测试造成的影响。

GTest 提供了三种常见的的事件：

全局事件

针对整个测试程序。实现全局的事件机制，需要创建一个自己的类，然后继承testing::Environment 类，然后分别实现成员函数 SetUp 和 TearDown，同时在 main 函数内进行调用testing::AddGlobalTestEnvironment(new MyEnvironment);函数添加全局的事件机制

#include <iostream> 
#include <gtest/gtest.h>
//全局事件:针对整个测试程序,提供全局事件机制,能够在测试之前配置测试环境
数据,测试完毕后清理数据
//先定义环境类,通过继承 testing::Environment 的派生类来完成
//重写的虚函数接口 SetUp 会在测试之前被调用; TearDown 会在测试完毕后调
用. 
std::unordered_map<std::string, std::string> dict;
class HashTestEnv : public testing::Environment {public:virtual void SetUp() override{std::cout << "测试前:提前准备数据!!\n";dict.insert(std::make_pair("Hello", "你好"));dict.insert(std::make_pair("hello", "你好"));dict.insert(std::make_pair("雷吼", "你好"));} virtual void TearDown() override{std::cout << "测试结束后:清理数据!!\n";dict.clear();} 
};
TEST(hash_case_test, find_test) {auto it = dict.find("hello");ASSERT_NE(it, dict.end());
} 
TEST(hash_case_test, size_test) {ASSERT_GT(dict.size(), 0);
} 
int main(int argc, char *argv[])
{ testing::AddGlobalTestEnvironment(new HashTestEnv );testing::InitGoogleTest(&argc, argv);return RUN_ALL_TESTS();
}

TestSuite事件

针对一个个测试套件。测试套件的事件机制我们同样需要去创建一个类，继承自 testing::Test，实现两个静态函数 SetUpTestCase 和 TearDownTestCase，测试套件的事件机制不需要像全局事件机制一样在 main 注册，而是需要将我们平时使用的 TEST 宏改为 TEST_F 宏。

  • SetUpTestCase() 函数是在测试套件第一个测试用例开始前执行
  • TearDownTestCase() 函数是在测试套件最后一个测试用例结束后执行
  • 需要注意 TEST_F 的第一个参数是我们创建的类名，也就是当前测试套件的名称，这样在 TEST_F 宏的测试套件中就可以访问类中的成员了。
#include <iostream>
#include <gtest/gtest.h>
//TestSuite:测试套件/集合进行单元测试,即,将多个相关测试归入一组的方式进
行测试,为这组测试用例进行环境配置和清理
//概念: 对一个功能的验证往往需要很多测试用例，测试套件就是针对一组相关测
试用例进行环境配置的事件机制
//用法: 先定义环境类,继承于 testing::Test 基类, 重写两个静态函数
SetUpTestCase/TearDownTestCase 进行环境的配置和清理
class HashTestEnv1 : public testing::Test {public:static void SetUpTestCase() {std::cout << "环境 1 第一个 TEST 之前调用\n";} static void TearDownTestCase() {std::cout << "环境 1 最后一个 TEST 之后调用\n";} public:std::unordered_map<std::string, std::string> dict;
};
// 注意,测试套件使用的不是 TEST 了,而是 TEST_F, 而第一个参数名称就是测试
套件环境类名称
// main 函数中不需要再注册环境了,而是在 TEST_F 中可以直接访问类的成员变量
和成员函数
TEST_F(HashTestEnv1, insert_test) {std::cout << "环境 1,中间 insert 测试\n";dict.insert(std::make_pair("Hello", "你好"));dict.insert(std::make_pair("hello", "你好"));dict.insert(std::make_pair("雷吼", "你好"));auto it = dict.find("hello");ASSERT_NE(it, dict.end());
} 
TEST_F(HashTestEnv1, sizeof) {std::cout << "环境 1,中间 size 测试\n";ASSERT_GT(dict.size(), 0);
} int main(int argc, char *argv[])
{ testing::InitGoogleTest(&argc, argv);return RUN_ALL_TESTS();
}

结构

能够看到在上例中，有一个好处，就是将数据与测试结合到同一个测试环境类中了，这样与外界的耦合度更低，代码也更清晰。

但是同样的，我们发现在两个测试用例中第二个测试用例失败了，这是为什么呢？这就涉及到了 TestCase 事件的机制。

TestCase 事件

针对一个个测试用例。测试用例的事件机制的创建和测试套件的基本一样，不同地方在于测试用例实现的两个函数分别是 SetUp 和 TearDown, 这两个函数也不是静态函数

  • SetUp()函数是在一个测试用例的开始前执行
  • TearDown()函数是在一个测试用例的结束后执行

也就是说，在 TestSuite/TestCase 事件中，每个测试用例，虽然它们同用同一个事件环境类，可以访问其中的资源，但是本质上每个测试用例的环境都是独立的，这样我们就不用担心不同的测试用例之间会有数据上的影响了，保证所有的测试用例都使用相同的测试环境进行测试。

#include <iostream>
#include <gtest/gtest.h>
//TestCase:测试用例的单元测试,即针对每一个测试用例都使用独立的测试环境数据进行测试
//概念:它是针对测试用例进行环境配置的一种事件机制
//用法:先定义环境类,继承于 testing::Test 基类, 在环境类内重写SetUp/TearDown 接口
class HashTestEnv2 : public testing::Test {public:static void SetUpTestCase() {std::cout << "环境 2 第一个 TEST 之前被调用,进行总体环境配置\n";} static void TearDownTestCase() {std::cout << "环境 2 最后一个 TEST 之后被调用,进行总体环境清理\n";} virtual void SetUp() override{std::cout << "环境 2 测试前:提前准备数据!!\n";dict.insert(std::make_pair("bye", "再见"));dict.insert(std::make_pair("see you", "再见"));} virtual void TearDown() override{std::cout << "环境 2 测试结束后:清理数据!!\n";dict.clear();}public:std::unordered_map<std::string, std::string> dict;
};TEST_F(HashTestEnv2, insert_test) {std::cout << "环境 2,中间测试\n";dict.insert(std::make_pair("hello", "你好"));ASSERT_EQ(dict.size(), 3);
} 
TEST_F(HashTestEnv2, size_test) {std::cout << "环境 2,中间 size 测试\n";auto it = dict.find("hello");ASSERT_EQ(it, dict.end());ASSERT_EQ(dict.size(), 2);
} 
int main(int argc, char *argv[])
{ testing::InitGoogleTest(&argc, argv);RUN_ALL_TESTS();return 0;
}

运行结果：

http://www.xdnf.cn/news/1213723.html

相关文章：

  • 基于成像空间转录组技术的肿瘤亚克隆CNV原位推断方法
  • android-PMS-创建新用户流程
  • VUE -- 基础知识讲解（三）
  • 记录Linux下ping外网失败的问题
  • 时序数据库厂商 TDengine 发布 AI 原生的工业数据管理平台 IDMP，“无问智推”改变数据消费范式
  • 问题1：uniapp在pages样式穿刺没有问题，在components组件中样式穿刺小程序不起效果
  • Django常见模型字段
  • 一篇文章读懂麦科信CP3008系列高频交直流电流探头
  • 基于数字信息化的全面研发项目管理︱裕太微电子股份有限公司研发项目管理部负责人唐超
  • 新手向:DeepSeek 部署中的常见问题及解决方案
  • Jupyter Notebook 中显示图片、音频、视频的方法汇总
  • RabbitMQ 发送方确认的两大工具 (With Spring Boot)
  • 开源 Arkts 鸿蒙应用 开发（十三）音频--MP3播放
  • 在线教育场景下AI应用，课程视频智能生成大纲演示
  • 大厂主力双塔模型实践与线上服务
  • 【swoole Windows 开发（swoole-cli 开发 hyperf）】
  • 算法训练营day36 动态规划④ 1049. 最后一块石头的重量 II、494. 目标和、474.一和零
  • 基于Rust与HDFS、YARN、Hue、ZooKeeper、MySQL
  • 【ee类保研面试】数学类---线性代数
  • 【iOS】weak修饰符
  • USRP捕获手机/路由器数据传输信号波形
  • 国内好用的智能三防手机，适合户外、工业、公共安全等场景
  • LLMs之Agent：GLM-4.5的简介、安装和使用方法、案例应用之详细攻略
  • 【MySQL学习|黑马笔记|Day3】多表查询（多表关系、内连接、外连接、自连接、联合查询、子查询），事务（简介、操作、四大体系、并发事务问题、事务隔离级别）
  • 智能车辆热管理测试方案——提升效能与保障安全
  • Three.js 与 WebXR：初识 VR/AR 开发
  • 多模通信·数据采集：AORO P9000U三防平板带来定制化解决方案
  • 如何在出售Windows11/10/8/7前彻底清除电脑数据
  • B站 XMCVE Pwn入门课程学习笔记（6）
  • 洛谷刷题7.30