Go语言项目如何在子文件夹中结构化组织测试代码？

你的需求完全可行，只是没符合Go的模块和测试包规则，下面给你讲清楚怎么弄：

核心问题分析 #

你遇到的导入错误，根源是包声明和目录结构不匹配：

• tests/server/server_test.go里写了package tests，但该文件实际在tests/server目录下，Go的包路径是基于目录层级的，这就导致模块找不到app/tests/server这个包。
• 另外，Go的测试不需要手动用t.Run导入其他测试函数来聚合，测试命令本身就支持批量运行。

正确的镜像测试结构实现 #

假设你的go.mod里模块名是app，按照以下步骤调整：

1. 目录结构保持你的预期 #

./internal
  ./server
    ./server.go  # package server
./tests
  ./server
    ./server_test.go  # 这里的包名有两种选择

2. 测试文件的包名选择 #

选项1：外部测试包（推荐，黑盒测试）

把tests/server/server_test.go的包名设为server_test，和源码包server区分开，只测试导出的API：

// ./tests/server/server_test.go
package server_test

import (
  "app/internal/server"
  "testing"
)

func TestBaseRoutes(t *testing.T) {
  // 这里写测试逻辑，调用server包的导出函数/方法
}

选项2：同名测试包（白盒测试）

如果需要测试internal/server里未导出的内容，可以把测试包名设为server，这时候Go会把测试文件和源码视为同一个包的一部分：

// ./tests/server/server_test.go
package server

import (
  "testing"
)

func TestBaseRoutes(t *testing.T) {
  // 可以直接调用server包内未导出的函数/变量
}

3. 运行测试的正确命令 #

• 单独运行server模块测试：go test ./tests/server
• 运行tests目录下所有测试：go test ./tests/...
• 运行整个项目所有测试（包括internal里的同包测试）：go test ./...

关于测试聚合的补充 #

如果确实需要手动聚合测试（比如统一入口），可以在tests根目录创建main_test.go，但要确保导入路径正确：

// ./tests/main_test.go
package tests

import (
  "app/tests/server"
  "testing"
)

func TestAll(t *testing.T) {
  t.Run("Server Routes", server.TestBaseRoutes)
  // 可以添加其他测试模块的子测试
}

这时候tests/server/server_test.go的包名必须是server（和目录名一致），这样app/tests/server才能被正确导入。

Go中型项目测试结构范式 #

Go社区对中型项目的测试结构通常有两种主流实践：

• 同包测试：测试文件和源码放在同一个目录，文件名以_test.go结尾，适合快速测试内部逻辑。
• 镜像外部测试：就是你想要的结构，把测试代码单独放在tests目录下，和源码目录一一对应，适合做隔离的黑盒测试，便于维护大型测试套件。

两种方式可以混用，根据测试场景选择即可。

内容的提问来源于stack exchange，提问作者Yanick Rochon