如何在Go语言REST API中管理模型映射并避免命名冲突

这是Go开发里非常常见的场景——我们需要对内的核心模型包含敏感或内部字段，对外暴露的API模型要隐藏这些细节，还想保留相同的结构体名称。用包级命名空间隔离是最符合Go语言习惯的解决方案，完全能满足你的需求，下面详细说下怎么落地：

1. 代码目录结构规划 #

首先把核心模型和API模型放到不同的包下，比如：

your-project/
├── api/                # 对外API相关的模型和接口
│   └── models.go
├── internal/           # 内部核心逻辑（可选，用domain包也可以）
│   └── domain/
│       └── user.go
└── main.go

把核心模型放在internal/domain（或者直接domain包），API模型放在api包，这样两个User结构体分属不同的命名空间，不会有冲突。

2. 核心模型代码（internal/domain/user.go） #

这里放包含敏感字段的核心业务模型：

package domain

type User struct {
    Name     string
    Password string // 内部敏感字段，不对外暴露
}

3. API模型代码（api/models.go） #

这里放对外暴露的模型，只保留需要的字段：

package api

type User struct {
    Name string // 只对外暴露Name字段
}

4. 在业务逻辑中引用并转换 #

在需要的地方（比如main.go或者服务层），通过包名来区分两个User类型，并且实现两者的转换：

package main

import (
    "your-project/api"
    "your-project/internal/domain"
)

func main() {
    // 假设从数据库获取到核心模型的User
    coreUser := domain.User{
        Name:     "Alice",
        Password: "secret123",
    }

    // 转换为API模型，自动过滤敏感字段
    apiUser := api.User{
        Name: coreUser.Name,
    }

    // 现在可以把apiUser返回给外部调用方了
    // ...
}

5. 优化：封装转换函数 #

如果转换逻辑重复出现，可以封装成函数减少冗余，比如在api包中添加：

package api

import "your-project/internal/domain"

func UserFromDomain(u domain.User) User {
    return User{
        Name: u.Name,
    }
}

这样在业务代码中直接调用api.UserFromDomain(coreUser)就完成转换了。

为什么这个方案可行？ #

Go语言中，类型的唯一性是由包路径+类型名共同决定的，domain.User和api.User是两个完全独立的类型，编译器不会认为它们是重复声明，完美解决了命名冲突的问题，同时也符合“关注点分离”的设计原则——核心模型专注业务逻辑，API模型专注对外契约。

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