Go Mapper：为Go模块化架构生成纯映射器函数，实现DTO与模型转换

go-mapper by cristiano-pacheco/ai-rules

1 周安装量

GitHub

安装命令

npx skills add https://github.com/cristiano-pacheco/ai-rules --skill go-mapper

开发 Go 代码规范

🇨🇳中文介绍

Go Mapper

为 GO 模块化架构生成纯映射器函数。

使用场景

将 HTTP 请求 DTO 映射为用例输入
将持久化模型映射为 HTTP 响应 DTO
在跨层的任意两种结构体表示之间进行映射
将一种结构体切片转换为另一种结构体切片
任何存在于模块内的结构体到结构体的转换

存放位置

所有映射器文件都位于 internal/modules/<module>/mapper/ 目录下。

每个领域概念对应一个文件：<name>_mapper.go（例如：user_mapper.go）。

函数签名模式

每个映射器函数都遵循 To 前缀约定。它接受一个或多个输入，并返回恰好一个输出，可选择性地返回一个错误。

func ToXxx(input InputType) OutputType
func ToXxx(input InputType) (OutputType, error)
func ToXxx(a TypeA, b TypeB) OutputType

仅返回单个输出。错误是唯一允许的第二个返回值。

文件结构

包声明和导入
公共映射器函数
私有辅助函数（公共函数之间共享的逻辑）

示例

基础映射器

🇺🇸English

Go Mapper

Generate pure mapper functions for GO modular architecture.

When to Use

Map HTTP request DTOs to use case inputs
Map persistence models to HTTP response DTOs
Map between any two struct representations across layers
Convert a slice of structs to a slice of another struct
Any struct-to-struct transformation that lives in a module

Location

All mapper files live in internal/modules/<module>/mapper/.

One file per domain concept: <name>_mapper.go (e.g., user_mapper.go).

Function Signature Pattern

Every mapper function follows the To prefix convention. It accepts one or more inputs and returns exactly one output, optionally with an error.

func ToXxx(input InputType) OutputType
func ToXxx(input InputType) (OutputType, error)
func ToXxx(a TypeA, b TypeB) OutputType

Single output only. Error is the only allowed second return value.

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

多输入参数的映射器

package mapper

import (
	"github.com/cristiano-pacheco/pingo/internal/modules/order/dto"
	"github.com/cristiano-pacheco/pingo/internal/modules/order/model"
)

func ToOrderResponse(order model.OrderModel, items []model.OrderItemModel) dto.OrderResponse {
	return dto.OrderResponse{
		ID:    order.ID,
		Total: order.Total,
		Items: toOrderItemResponses(items),
	}
}

func toOrderItemResponses(items []model.OrderItemModel) []dto.OrderItemResponse {
	responses := make([]dto.OrderItemResponse, len(items))
	for i, item := range items {
		responses[i] = dto.OrderItemResponse{
			ID:       item.ID,
			Name:     item.ProductName,
			Quantity: item.Quantity,
			Price:    item.Price,
		}
	}
	return responses
}

返回错误的映射器

当转换可能失败时使用（例如，映射过程中的解析、验证）。

package mapper

import (
	"github.com/cristiano-pacheco/pingo/internal/modules/product/dto"
	"github.com/cristiano-pacheco/pingo/internal/modules/product/errs"
	"github.com/cristiano-pacheco/pingo/internal/modules/product/model"
)

func ToProductModel(req dto.CreateProductRequest) (model.ProductModel, error) {
	price, err := parsePrice(req.Price)
	if err != nil {
		return model.ProductModel{}, errs.ErrInvalidPrice
	}
	return model.ProductModel{
		Name:  req.Name,
		Price: price,
	}, nil
}

当映射单个项目时，如果该类型出现在集合中，则添加相应的列表函数。

func ToArticleResponse(a model.ArticleModel) dto.ArticleResponse {
	return dto.ArticleResponse{
		ID:     a.ID,
		Title:  a.Title,
		Author: toAuthorResponse(a),
	}
}

func ToArticleListResponse(models []model.ArticleModel) []dto.ArticleResponse {
	responses := make([]dto.ArticleResponse, len(models))
	for i, a := range models {
		responses[i] = ToArticleResponse(a)
	}
	return responses
}

func toAuthorResponse(a model.ArticleModel) dto.AuthorResponse {
	return dto.AuthorResponse{
		ID:   a.AuthorID,
		Name: a.AuthorName,
	}
}

文件：<name>_mapper.go，位于 mapper/ 包中
公共函数：ToXxx — 其中 Xxx 是输出类型的名称（例如：ToUserResponse、ToCreateUserInput）
私有辅助函数：toXxx — 小写前缀，用于共享的子映射逻辑
切片变体：ToXxxList 或 ToXxxListResponse

仅包含函数 — 没有结构体、没有接口、没有构造函数、没有端口文件
To 前缀 — 每个公共函数都以 To 开头
单一输出 — 一个返回值，或者一个返回值加错误
不使用 context.Context — 映射器是纯转换，不涉及 I/O
无副作用 — 无日志记录、无数据库调用、无外部依赖
私有辅助函数 — 将共享的子映射逻辑提取到私有函数中
函数上无注释 — 函数名通过 To 约定实现自说明
切片辅助函数 — 当映射的类型出现在集合中时，添加一个列表变体
仅在转换可能失败时返回错误 — 优先使用无错误签名；仅在解析或转换失败时使用错误

在 mapper/<name>_mapper.go 中创建映射器文件
运行 make lint 以验证代码质量
运行 make nilaway 进行静态分析

Package declaration and imports
Public mapper functions
Private helper functions (shared logic between public functions)

package mapper

import (
	"github.com/cristiano-pacheco/pingo/internal/modules/user/dto"
	"github.com/cristiano-pacheco/pingo/internal/modules/user/model"
	"github.com/cristiano-pacheco/pingo/internal/modules/user/usecase"
)

func ToCreateUserInput(req dto.CreateUserRequest) usecase.CreateUserInput {
	return usecase.CreateUserInput{
		Name:  req.Name,
		Email: req.Email,
	}
}

func ToUserResponse(u model.UserModel) dto.UserResponse {
	return dto.UserResponse{
		ID:        u.ID,
		Name:      u.Name,
		Email:     u.Email,
		CreatedAt: u.CreatedAt,
	}
}

func ToUserListResponse(models []model.UserModel) []dto.UserResponse {
	responses := make([]dto.UserResponse, len(models))
	for i, u := range models {
		responses[i] = ToUserResponse(u)
	}
	return responses
}

Mapper with multiple inputs

package mapper

import (
	"github.com/cristiano-pacheco/pingo/internal/modules/order/dto"
	"github.com/cristiano-pacheco/pingo/internal/modules/order/model"
)

func ToOrderResponse(order model.OrderModel, items []model.OrderItemModel) dto.OrderResponse {
	return dto.OrderResponse{
		ID:    order.ID,
		Total: order.Total,
		Items: toOrderItemResponses(items),
	}
}

func toOrderItemResponses(items []model.OrderItemModel) []dto.OrderItemResponse {
	responses := make([]dto.OrderItemResponse, len(items))
	for i, item := range items {
		responses[i] = dto.OrderItemResponse{
			ID:       item.ID,
			Name:     item.ProductName,
			Quantity: item.Quantity,
			Price:    item.Price,
		}
	}
	return responses
}

Mapper with error return

Use when transformation can fail (e.g., parsing, validation during mapping).

package mapper

import (
	"github.com/cristiano-pacheco/pingo/internal/modules/product/dto"
	"github.com/cristiano-pacheco/pingo/internal/modules/product/errs"
	"github.com/cristiano-pacheco/pingo/internal/modules/product/model"
)

func ToProductModel(req dto.CreateProductRequest) (model.ProductModel, error) {
	price, err := parsePrice(req.Price)
	if err != nil {
		return model.ProductModel{}, errs.ErrInvalidPrice
	}
	return model.ProductModel{
		Name:  req.Name,
		Price: price,
	}, nil
}

Slice mapper pattern

When mapping a single item, add a corresponding list function if the type appears in collections.

func ToArticleResponse(a model.ArticleModel) dto.ArticleResponse {
	return dto.ArticleResponse{
		ID:     a.ID,
		Title:  a.Title,
		Author: toAuthorResponse(a),
	}
}

func ToArticleListResponse(models []model.ArticleModel) []dto.ArticleResponse {
	responses := make([]dto.ArticleResponse, len(models))
	for i, a := range models {
		responses[i] = ToArticleResponse(a)
	}
	return responses
}

func toAuthorResponse(a model.ArticleModel) dto.AuthorResponse {
	return dto.AuthorResponse{
		ID:   a.AuthorID,
		Name: a.AuthorName,
	}
}

File: <name>_mapper.go in mapper/ package
Public functions: ToXxx — where Xxx is the output type name (e.g., ToUserResponse, ToCreateUserInput)
Private helpers: toXxx — lowercase prefix for shared sub-mapping logic
Slice variants: ToXxxList or ToXxxListResponse

Functions only — no structs, no interfaces, no constructors, no port files
To prefix — every public function starts with To
Single output — one return value, or one return value + error
Nocontext.Context — mappers are pure transformations, no I/O
No side effects — no logging, no database calls, no external dependencies
Private helpers — extract shared sub-mapping logic into private functions
No comments on functions — function names are self-documenting via the To convention
Slice helpers — add a list variant when the mapped type appears in collections
Error return only when transformation can fail — prefer no-error signatures; use error only for parsing or conversion failures

Create mapper file in mapper/<name>_mapper.go
Run make lint to verify code quality
Run make nilaway for static analysis

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

109,600 周安装

Go Mapper：为Go模块化架构生成纯映射器函数，实现DTO与模型转换

🇨🇳中文介绍

Go Mapper

使用场景

存放位置

函数签名模式

文件结构

示例

基础映射器

🇺🇸English

Go Mapper

When to Use

Location

Function Signature Pattern

相关 Skills

多输入参数的映射器

返回错误的映射器

切片映射模式

命名规范

规则

工作流程

File Structure

Examples

Basic mapper

Mapper with multiple inputs

Mapper with error return

Slice mapper pattern

Naming

Rules

Workflow

最新 Skills