go 语言允许将测试文件放在独立子目录中，但需遵循特定规则：测试文件必须使用独立包名（如 test），通过导入被测包调用其导出函数，且被测函数必须首字母大写（即导出）。直接跨目录复用同名包会导致未定义标识符错误。
在 Go 工程实践中，虽然标准约定是将 _test.go 文件与被测源码置于
同一目录、同一包内
（如 module1.go 和 module1_test.go 同属 package package1），但当项目规模扩大、测试逻辑复杂时，确实存在对更清晰目录结构的需求。Go 官方并不禁止将测试文件移至子目录，只是需满足以下关键条件：
✅ 正确做法：测试文件需作为独立包存在
测试文件所在目录（如 test/）必须声明
不同于被测包的包名
（通常命名为 test 或 package1_test）；
必须显式 import 被测包（如 "your-module-path/package1"），通过包名限定符调用其
导出符号
；
被测函数/变量必须首字母大写（如 SomeFunc），否则无法被其他包访问。
✅ 示例结构（推荐路径）
✅ package1/module1.go
✅ package1/test/module1_test.go
⚠️ 注意事项：不可使用 package package1：若测试文件仍声明 package package1，Go 会将其视为同一包的另一文件，但因物理路径不同（非同一目录），编译器无法识别其共享作用域，导致 undefined: someFunc 错误。路径必须可导入：确保 your-module 已正确初始化为 Go 模块（含 go.mod），且导入路径与 go list 或 go build 识别的路径一致。不适用于白盒测试内部逻辑：此方式无法访问 package1 中的未导出（小写首字母）函数、变量或类型，仅适合黑盒/集成测试场景。若需深度单元测试私有逻辑，应坚持同目录同包模式。
? 总结
将测试放入子目录是可行的，但本质是构建一个
依赖被测包的独立测试包
，而非“同包拆分”。它更适合端到端测试、集成测试或需要隔离测试依赖的场景；对于常规单元测试，仍强烈建议保持 xxx.go 与 xxx_test.go 同目录同包——这是 Go 生态最广泛支持、工具链最友好（如 go test -cover、IDE 跳转、gopls 补全）的实践方式。权衡可维护性与工程惯性，优先遵守约定优于配置原则。
GitHub Copilot
GitHub AI编程工具，实时编程建议
下载
your-module/
├── go.mod
├── package1/
│ ├── module1.go // package package1
│ └── test/
│ └── module1_test.go // package testpackage package1
// SomeFunc 是导出函数，可被其他包调用
func SomeFunc() {
// 实现逻辑
}package test
import (
"testing"
"your-module/package1" // 替换为你的实际模块路径（如 github.com/user/repo/package1）
)
func TestSomeFunc(t *testing.T) {
package1.SomeFunc() // ✅ 正确：通过包名调用导出函数
}