go 支持将测试文件放在独立子目录（如 `test/`）中，但需满足关键条件：测试文件必须使用独立包名（如 `package test`），显式导入被测包，并仅调用其导出（首字母大写）的标识符。
在 Go 工程实践中，随着模块规模扩大，将测试文件与源码混置（如 module1.go 与 module1_test.go 同级）确实会降低可维护性。虽然 Go 官方推荐“测试与被测代码同包同目录”的惯例（便于访问未导出符号），但技术上完全允许将测试文件置于子目录——前提是遵循 Go 的包可见性规则和导入机制。
✅ 正确做法：分离包 + 显式导入 + 导出接口
假设你的主模块路径为 github.com/yourname/project/package1，结构应调整为：
package1/
├── module1.go # 被测源码
└── test/
└── module1_test.go # 独立测试包module1.go（修正为导出函数）：
package package1
// SomeFunc 是导出函数（首字母大写），可供外部包调用
func SomeFunc() {
// 实现逻辑
}test/module1_test.go（独立包 + 显式导入）：
package test // 注意：不再是 package package1！
import (
"testing"
"github.com/yourname/project/package1" // 替换为你的实际模块路径
)
func TestSomeFunc(t *testing.T) {
package1.SomeFunc() // 通过包名调用导出函数
}⚠️ 关键注意事项
- 不可访问未导出标识符：子目录中的测试属于独立包，无法直接使用 someFunc()（小写）等非导出符号。所有被测函数、类型、变量必须以大写字母开头。
- 包名必须不同：测试文件不能声明 package package1，否则 Go 会将其视为同一包，导致编译错误或语义混乱；应使用 package test 或其他有意义的包名（如 package package1test）。
- 模块路径需准确：import 语句中的路径必须与 go.mod 中定义的模块路径一致（如 github.com/yourname/project/package1），而非相对路径或本地文件系统路径。
- 运行测试方式不变：仍使用 go test ./package1/test 或 go test ./...，Go 工具链会自动识别 _test.go 文件。
? 为什么官方不推荐？权衡取舍
将测试分离到子目录虽提升物理隔离性，但牺牲了对内部实现细节的测试能力（例如无法验证私有辅助函数逻辑、结构体字段状态等）。因此，主流项目（如 Go 标准库、Kubernetes）普遍采用同包测试——既保证测试深度，又避免包循环依赖风险。
若坚持分目录，建议仅用于集成测试（integration tests） 或 端到端测试（e2e tests），而非单元测试。对于单元测试，更推荐通过合理命名（如 module1_internal_test.go）和目录分组（如 internal/）来组织复杂逻辑，而非强行拆分包结构。
最终，结构服务于可维护性，而非教条。选择方案前，请评估团队规范、测试粒度需求及对封装边界的容忍度。
