Go语言中如何处理两个包内相似结构体的解耦问题？

我是Go语言新手，正在做大规模重构以尽可能减少包间依赖，目前整体进展顺利，但遇到一个棘手场景：包a和包b内有结构完全一致的结构体（包含嵌套子结构体），但Go不允许跨包直接转换这些结构体。

最初为了解耦才让两个包重复定义结构体，原代码是一个包引用另一个包的结构体。我目前想到三个思路：

• 让包b引用包a的TzConfig结构体，但这会引入依赖，违背解耦初衷；
• 定义接口通过方法获取Loc的值，但要给纯数据结构写大量方法，显得冗余；
• 将TzConfig移到第三个公共模块，让两个包共同引用。

想请教有实际经验的开发者，这种场景的最佳处理方案是什么？

原代码示例 #

包a

package a

import "time"

type Cfg struct {
    Addr                 string
    Loc                  TzConfig
}

type TzConfig struct {
    String string
    TZ     *time.Location `validate:"noDescent"`
}

func GetCfg() Cfg {
    t, _ := time.LoadLocation(`MST`)
    return Cfg{
        Addr: "abc",
        Loc:  TzConfig{
            String: "MST",
            TZ:     t,
        },
    }
}

包b

package b

import (
    "fmt"
    "time"
)

type Cfg struct {
    Addr                 string
    Loc                  TzConfig
}

type TzConfig struct {
    String string
    TZ     *time.Location `validate:"noDescent"`
}

func DoSomethingWithConfig(c Cfg) {
    fmt.Println(c)
}

main包

package main

import (
    "a"
    "b"
)

func main() {
     c := a.GetCfg()
     // 此处无法直接转换，原代码中的b.Cg(c)为假设的转换函数
     // b.DoSomethingWithConfig(b.Cfg(c))
     fmt.Println(c)
}

实际开发中的最优方案分析 #

在Go的解耦场景下，将重复结构体提取到公共模块（方案3）是最符合长期维护性的选择，核心原因如下：

• 消除重复代码：重复定义意味着后续结构变更需要同步修改多处，极易引发不一致的bug；
• 平衡解耦与复用：公共模块仅承载纯数据结构，不包含业务逻辑，既保持了a、b包的解耦，又实现了数据结构的复用；
• 扩展性更强：后续其他包需要使用相同结构时，可直接引用公共模块，无需重复定义。

对另外两个方案的补充说明

• 方案1：直接引入依赖会打破重构的核心目标（减少依赖），若后续包a结构变更，包b会被迫同步修改，耦合度反而升高，不推荐；
• 方案2：为纯数据结构体编写接口方法属于冗余设计，Go的接口是行为抽象，而非数据结构抽象，强行适配会增加不必要的代码复杂度，违背Go的简洁原则。

重构后的代码示例 #

公共包（如pkg/config）

package config

import "time"

type TzConfig struct {
    String string
    TZ     *time.Location `validate:"noDescent"`
}

type Cfg struct {
    Addr string
    Loc  TzConfig
}

包a

package a

import (
    "time"
    "your-project/pkg/config"
)

func GetCfg() config.Cfg {
    t, _ := time.LoadLocation(`MST`)
    return config.Cfg{
        Addr: "abc",
        Loc: config.TzConfig{
            String: "MST",
            TZ:     t,
        },
    }
}

包b

package b

import (
    "fmt"
    "your-project/pkg/config"
)

func DoSomethingWithConfig(c config.Cfg) {
    fmt.Println(c)
}

main包

package main

import (
    "your-project/a"
    "your-project/b"
)

func main() {
    c := a.GetCfg()
    b.DoSomethingWithConfig(c)
}

额外建议 #

若担心公共模块膨胀成“大泥球”，可按功能细分公共包，比如专门存放配置结构的pkg/config、通用工具的pkg/utils等，保持公共包的单一职责。

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