在 Go 单元测试中，为接口创建可复用的 Mock 结构体应统一存放于独立的 mock 包中，避免命名冲突与代码重复；推荐结合 GoMock 等工具自动生成 Mock，兼顾一致性、可维护性与开发效率。
在 go 单元测试中，为接口创建可复用的 mock 结构体应统一存放于独立的 `mock` 包中，避免命名冲突与代码重复；推荐结合 gomock 等工具自动生成 mock，兼顾一致性、可维护性与开发效率。
在 Go 工程实践中，Mock 的组织方式直接影响测试代码的可读性、复用性与长期可维护性。若将 Mock 结构体直接定义在单个 _test.go 文件中，虽简单直接，但一旦多个测试文件需模拟同一依赖（如 UserService 接口），就会因同包内重复定义同名结构体而触发编译错误——Go 不允许同一包中存在两个同名类型。
✅ 推荐方案：使用独立的 mock 子包
在项目根目录或 internal/ 下创建 mock/ 目录（例如 mock/user_service.go），并为其声明独立包名（如 mock）：
// mock/user_service.go
package mock
import "your-project/internal/user"
// UserService implements user.Service interface for testing.
type UserService struct {
GetFunc func(id int) (*user.User, error)
}
func (m *UserService) Get(id int) (*user.User, error) {
if m.GetFunc != nil {
return m.GetFunc(id)
}
return &user.User{ID: id, Name: "mock-user"}, nil
}测试中即可跨包引用：
// internal/handler/user_handler_test.go
import (
"your-project/mock"
"your-project/internal/user"
)
func TestUserHandler_Get(t *testing.T) {
mockSvc := &mock.UserService{
GetFunc: func(id int) (*user.User, error) {
return &user.User{ID: id, Name: "test-user"}, nil
},
}
handler := NewUserHandler(mockSvc)
// ...
}? 进阶建议：优先使用自动化 Mock 工具
手动编写 Mock 易出错且维护成本高。推荐使用 GoMock（官方维护）生成强类型、零手误的 Mock 实现：
- 安装：
go install github.com/golang/mock/mockgen@latest - 为
user.Service接口生成 Mock：mockgen -source=internal/user/service.go -destination=mock/mock_user_service.go -package=mock
- 生成的
mock.MockUserService自动实现全部方法，并支持EXPECT()断言，大幅提升测试表达力与可靠性。
⚠️ 注意事项
- 避免在
mock/包中引入生产代码依赖（如database/sql或http.Client），保持 Mock 层纯粹； - Mock 包不参与构建，仅用于测试，应在
go.mod中通过//go:build test注释或单独mockmodule（如your-project/mock）隔离； - 对高频使用的第三方依赖（如
github.com/aws/aws-sdk-go-v2），可借助其官方提供的fakes包，而非自行 Mock。
综上，将 Mock 统一收口至 mock 包 + 工具链自动生成，是 Go 项目中兼顾工程规范与开发效能的最佳实践。
