Go子文件夹中的测试：初学者完整指南

Go子文件夹中的测试：解决教程中避而不谈的问题

您是否曾经编写过Go测试，发现它们在项目根目录下运行良好，但一旦移到子文件夹中就全部失效？熟悉吗？如果是这样——您并不孤单。Stack Overflow上的问题"Golang tests in sub-directory"已经积累了数千次浏览。这并不奇怪：Go文档对此语焉不详，而初学者开发者常常感到困惑。

在本文中，我们将探讨如何正确组织使用嵌套包的Go测试，为什么需要这样做，以及如何避免踩坑。开始吧！

为什么子文件夹中的测试是个痛点？

想象一下：您有一个项目，其结构如下：

myapp/\n├── main.go\n├── go.mod\n└── utils/\n    ├── math.go\n    └── math_test.go

您在根目录运行Go test——一切正常。但当您尝试从utils文件夹运行测试时，Go报错："package myapp/utils is not in GOROOT"。熟悉这个错误吗？

问题在于Go处理的是包，而不是文件夹。当您创建子文件夹时，实际上是在创建一个新的包。其中的测试需要根据项目的模块结构来运行。但让我们按顺序来。

基础：Go如何看待测试

在Go中，测试是后缀为_test.go的普通文件。它们可以位于：

\n
• 同一个包中（白盒测试）——可以访问未导出的函数。
\n
• 后缀为_test的独立包中（黑盒测试）——像外部用户一样测试包。
\n

当您将测试放入子文件夹时，您创建了一个新的包。例如，utils文件夹就是utils包。其中的测试必须属于这个包。

正确结构的示例

myapp/\n├── go.mod\n├── main.go\n└── utils/\n    ├── math.go        // package utils\n    └── math_test.go   // package utils

在math.go文件中：

package utils\n\nfunc Add(a, b int) int {\n    return a + b\n}

在math_test.go文件中：

package utils\n\nimport "testing"\n\nfunc TestAdd(t *testing.T) {\n    result := Add(2, 3)\n    if result != 5 {\n        t.Errorf("Expected 5, got %d", result)\n    }\n}

现在从项目根目录运行测试：

go test ./utils/

或者从utils文件夹：

cd utils\ngo test

一切正常！但如果您的结构更复杂呢？

嵌套子文件夹：比看起来更深

假设您有一个项目，结构如下：

myapp/\n├── go.mod\n├── main.go\n└── services/\n    ├── user/\n    │   ├── user.go\n    │   └── user_test.go\n    └── order/\n        ├── order.go\n        └── order_test.go

这里每个子文件夹都是一个独立的包。要递归运行所有测试，请使用三个点：

go test ./...

这个命令会找到项目中的所有包并运行它们的测试。对于CI/CD非常方便！

如果测试与代码在同一文件夹中呢？

有时开发者将测试放在与主代码相同的文件夹中。这对于小型项目来说是可以的。但对于大型项目，最好将测试放在单独的子文件夹中——这样结构会更清晰。

典型错误及其解决方案

让我们分析一下初学者在处理Golang tests in sub-directory时最常见的错误。

错误1："package is not in GOROOT"

原因：您试图从子文件夹运行测试，但没有指定模块。Go不知道包属于哪个模块。

解决方案：确保根目录下有go.mod文件