Go语言金额处理包API设计：ExchangeTo方法最佳签名选择

针对你的Money结构体ExchangeTo方法的三种签名方案，结合Go语言设计习惯和金额处理的通用需求，分析如下：

方案三（无返回值修改接收者）：不推荐 #

这种方案直接修改原Money实例的Currency和Cents，违背了金额处理的核心原则——金额应该是不可变值。用户在兑换货币时，几乎都是期望得到一个新的目标货币金额，而不是让原有金额“凭空变成另一种货币”。这种带副作用的设计会导致代码逻辑混乱，比如不小心复用了被修改的原实例，引发难以追踪的bug，完全不适合通用型包的设计。

方案一（指针接收者+返回指针）：可选但有局限 #

• 优势：避免结构体拷贝（虽然你的Money结构体很小，拷贝成本可以忽略），适合后续结构体扩容的场景；返回指针支持链式调用。
• 劣势：调用时如果原实例是值类型，需要显式取地址（或依赖Go的自动转换），增加了使用门槛；返回指针意味着用户需要注意是否存在共享状态（比如你的bank指针字段），语义上不如值返回清晰。

方案二（值接收者+返回结构体）：推荐使用 #

这是最符合Go语言值语义和金额处理需求的方案：

• 不可变性保障：兑换操作返回一个全新的Money值，原实例完全不受影响，用户无需担心意外修改，代码逻辑更安全。
• 使用便捷：不管原实例是值还是指针，都可以直接调用该方法（Go会自动处理值与指针接收者的转换），对用户更友好。
• 语义清晰：返回值明确表示“兑换后的新金额”，符合用户对货币兑换操作的直觉认知。

结合通用型包的易用性和安全性要求，方案二是最优选择。你可以参考Go标准库中类似的不可变值类型设计（比如time.Time的Add、UTC等方法），保持一致的设计风格。

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