0

0

如何在Golang中编写第一个单元测试 Go语言testing包入门指南

P粉602998670

P粉602998670

发布时间:2026-02-27 11:58:03

|

859人浏览过

|

来源于php中文网

原创

第一个能跑通的go测试函数需满足:文件名以_test.go结尾、与被测代码同包、函数名为testxxx且参数为testing.t;例如func testadd(t testing.t) { got := add(2,3); want := 5; if got != want { t.errorf("add(2,3) = %d, want %d", got, want) } }。

如何在golang中编写第一个单元测试 go语言testing包入门指南

怎么写第一个 go test 能跑通的测试函数

Go 的测试不是靠第三方库,而是语言原生支持——只要文件名以 _test.go 结尾、函数名以 Test 开头、参数是 *testing.T,就能被 go test 自动发现。

常见错误:把测试函数写成 func testAdd()(没大写、没参数)、或者放在 main.go 里(没加 _test 后缀),go test 直接静默跳过,不报错也不运行。

  • 测试文件必须和被测代码在同一个包下(比如 calc.gocalc_test.go 都在 main 包)
  • 函数签名必须是 func TestXxx(t *testing.T),少一个星号或换个参数名都不行
  • 运行命令就是 go test(当前目录)或 go test ./...(整个模块)

示例:add.go 里有 func Add(a, b int) int { return a + b },对应测试写在 add_test.go

func TestAdd(t *testing.T) {
    got := Add(2, 3)
    want := 5
    if got != want {
        t.Errorf("Add(2,3) = %d, want %d", got, want)
    }
}

t.Fatalt.Error 到底该用哪个

区别不在“严重程度”,而在“是否继续执行”:用 t.Error 会记录失败但跑完所有断言;t.Fatal 一触发就立刻终止当前测试函数,后续语句不执行。

立即学习go语言免费学习笔记(深入)”;

典型误用:在循环里对每个元素做检查,却用了 t.Fatal——结果第一个失败就停了,后面几十个 case 全被跳过,误以为“只有一处问题”。

Getsound
Getsound

基于当前天气条件生成个性化音景音乐

下载
  • 单个断言后还想继续验证其他逻辑 → 用 t.Error
  • 前置条件不满足(比如文件打不开、依赖服务连不上)→ 用 t.Fatal 快速退出
  • 想提前返回又不想写 return?不行。t.Fatal 不会自动 return,必须自己跟一句 return

为什么 go test 什么都没输出,像没跑一样

默认情况下,go test 只在测试失败或显式调用 t.Log/t.Logf 时才打印内容。全绿通过时,它真的就只输出 ok ... 0.001s ——这不是卡住,是设计如此。

容易踩的坑:以为测试没运行,其实是通过了;或者调试时加了 fmt.Println,结果被测试框架屏蔽(fmt 输出不进测试日志)。

  • 想看每轮测试的中间值 → 改用 t.Log("value:", x)
  • 想强制看到所有测试名称和耗时 → 加 -v 参数:go test -v
  • 想看覆盖率 → go test -cover,但注意它只统计被测试代码行,不包括 if false { ... } 这类死代码

测试私有函数(未导出函数)要改名或拆包吗

不用。Go 的测试文件和源文件在同一包内,能直接访问所有标识符,包括小写开头的函数、变量、结构体字段。

常见误解:觉得“私有=不能测”,于是把 parseConfig 改成 ParseConfig 暴露出去,反而破坏封装。其实只要它们在同一个 package xxx 下,测试就能调。

  • 被测函数是 func parseLine(s string) (int, error) → 测试里直接调 parseLine("123")
  • 唯一例外:跨包测试(比如想测 internal/xxx 里的函数),那确实需要重构——但那是架构问题,不是测试技术问题
  • 如果私有函数逻辑太重、难以构造输入,优先考虑的是提取纯函数或改接口,而不是暴露它

真正容易被忽略的是测试边界:比如空字符串、负数、超长输入、并发调用。这些不会因为函数“私有”就自动绕开,得手动覆盖。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

207

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

242

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

351

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

214

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

406

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

385

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

200

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

1151

2025.06.17

Golang 并发编程模型与工程实践:从语言特性到系统性能
Golang 并发编程模型与工程实践:从语言特性到系统性能

本专题系统讲解 Golang 并发编程模型,从语言级特性出发,深入理解 goroutine、channel 与调度机制。结合工程实践,分析并发设计模式、性能瓶颈与资源控制策略,帮助将并发能力有效转化为稳定、可扩展的系统性能优势。

0

2026.02.27

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 5.6万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号