必须放在以 _test.go 结尾的文件中，这是 Go 官方约定和 go test 工具的硬性要求；文件名、测试函数命名（TestXxx）、签名（*testing.T）及包声明（xxx_test 或 xxx）任一错误都会导致“no tests to run”。

应该放在 _test.go 文件里，这是 Go 官方约定和 go test 工具的硬性要求。

为什么必须用 _test.go 后缀？

Go 的测试机制依赖文件名识别测试代码：go test 默认只编译并运行以 _test.go 结尾的文件。其他命名（比如 test_utils.go 或 helper_test.go 但没下划线）会被忽略，即使里面写了 TestXxx 函数也不会执行。

• go build 和 go run 会直接跳过 _test.go 文件，避免把测试代码打进生产二进制
• 测试文件可声明独立的 package xxx_test，用于黑盒测试（访问被测包的导出符号，但不访问未导出字段/函数）
• 若测试需要访问内部实现（如 unexported 方法），可与源码同包（即 package xxx），此时也必须用 _test.go 后缀，否则编译失败（包名冲突或无法导入）

xxx_test.go 里该写什么？

不是所有测试相关代码都适合塞进 _test.go。区分清楚三类内容：

• 真正执行的测试函数（func TestXxx(t *testing.T)）——必须放在 _test.go
• 测试辅助函数（如构造 mock、初始化 fixture）——推荐放在同名 _test.go 中，避免跨包调用复杂化
• 可复用的测试工具（如通用断言库、HTTP 测试客户端）——建议单独建 testutil 包，用普通 .go 后缀，导入时加 /testutil 路径；否则容易引发循环导入或测试包污染

常见错误：文件名对了但测试不运行

即使后缀正确，以下情况仍会导致 go test 找不到或跳过测试：

立即学习“go语言免费学习笔记（深入）”；

• 函数名不符合规范：必须是 Test 开头 + 驼峰，如 TestHandleRequest；testHandleRequest 或 TEST_HandleRequest 都无效
• 签名错误：参数必须是 *testing.T（单元测试）或 *testing.B（基准测试），多一个参数或类型不对就静默忽略
• 包声明问题：黑盒测试需声明 package xxx_test，且文件中不能 import 原包（否则循环依赖）；同包测试则必须声明 package xxx，且不能有 import "xxx"
• 执行范围限制：默认只跑当前目录，go test ./... 才递归所有子目录；子目录下没有 _test.go 就不会触发其测试

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

测试文件命名、函数签名、包声明这三点只要错一个，go test 就不会报错，而是直接说 no tests to run —— 这是最容易卡住人的地方。

# go  # golang  # 工具  # golang测试  # 为什么  # 递归  # 循环  # http  # 放在  # 这是  # 跳过  # 就不  # 找不到  # 下划线  # 能有  # 写了  # 不符合 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做？  高防服务器租用首荐平台，企业级优惠套餐快速部署  详解jQuery中的事件  JS中使用new Date(str)创建时间对象不兼容firefox和ie的解决方法(两种)  绝密ChatGPT指令：手把手教你生成HR无法拒绝的求职信  Laravel Telescope怎么调试_使用Laravel Telescope进行应用监控与调试  Laravel如何使用Passport实现OAuth2？（完整配置步骤）  JavaScript中的标签模板是什么_它如何扩展字符串功能  Laravel如何处理表单验证？（Requests代码示例）  php做exe能调用系统命令吗_执行cmd指令实现方式【详解】  如何在建站宝盒中设置产品搜索功能？  西安专业网站制作公司有哪些,陕西省建行官方网站？  如何快速选择适合个人网站的云服务器配置？  C#如何调用原生C++ COM对象详解  Win10如何卸载预装Edge扩展_Win10卸载Edge扩展教程【方法】  动图在线制作网站有哪些,滑动动图图集怎么做？  详解Nginx + Tomcat 反向代理 负载均衡 集群 部署指南  使用Dockerfile构建java web环境  Android自定义控件实现温度旋转按钮效果  Laravel中间件如何使用_Laravel自定义中间件实现权限控制  Gemini怎么用新功能实时问答_Gemini实时问答使用【步骤】  Laravel请求验证怎么写_Laravel Validator自定义表单验证规则教程  为什么php本地部署后css不生效_静态资源加载失败修复技巧【技巧】  Laravel的路由模型绑定怎么用_Laravel Route Model Binding简化控制器逻辑  怎么用AI帮你设计一套个性化的手机App图标？  html5的keygen标签为什么废弃_替代方案说明【解答】  MySQL查询结果复制到新表的方法(更新、插入)  音乐网站服务器如何优化API响应速度？  Win11怎么设置虚拟桌面 Win11新建多桌面切换操作【技巧】  郑州企业网站制作公司,郑州招聘网站有哪些？  百度浏览器ai对话怎么关 百度浏览器ai聊天窗口隐藏  网站制作大概多少钱一个,做一个平台网站大概多少钱？  活动邀请函制作网站有哪些,活动邀请函文案？  微信小程序制作网站有哪些,微信小程序需要做网站吗？  如何在万网ECS上快速搭建专属网站？  如何在Windows虚拟主机上快速搭建网站？  用yum安装MySQLdb模块的步骤方法  如何在七牛云存储上搭建网站并设置自定义域名？  如何用IIS7快速搭建并优化网站站点？  Laravel全局作用域是什么_Laravel Eloquent Global Scopes应用指南  大连 网站制作,大连天途有线官网？  如何在阿里云虚拟服务器快速搭建网站？  Laravel怎么连接多个数据库_Laravel多数据库连接配置  Laravel如何使用Livewire构建动态组件？（入门代码）  Bootstrap整体框架之CSS12栅格系统  android nfc常用标签读取总结  网站视频制作书签怎么做,ie浏览器怎么将网站固定在书签工具栏？  Python正则表达式进阶教程_复杂匹配与分组替换解析  详解MySQL数据库的安装与密码配置  Python数据仓库与ETL构建实战_Airflow调度流程详解