在 go 中，若在一个函数内定义多个相互引用的结构体类型（如 config 引用未定义的 group），因类型作用域和声明顺序限制，会导致“undefined”编译错误；正确做法是将被引用的类型（如 group）定义在引用它的类型（如 config）之前。

在 go 中，若在一个函数内定义多个相互引用的结构体类型（如 config 引用未定义的 group），因类型作用域和声明顺序限制，会导致“undefined”编译错误；正确做法是将被引用的类型（如 group）定义在引用它的类型（如 config）之前。

Go 是一种静态、自上而下解析的语言，函数体内类型的声明遵循严格的顺序可见性规则：一个类型只能引用此前已声明完成的类型。在原始代码中，config 结构体在 group 定义之前就尝试使用 []group，此时 group 尚未声明，编译器自然报错 undefined: group。

✅ 正确写法是先定义被依赖的类型，再定义依赖它的类型：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

func main() {
    // 先定义 group（被引用方）
    type group struct {
        Group        string `mapstructure:"group"`
        TargetPrefix string `mapstructure:"target_prefix"`
        // 注意：若需嵌套 targets，须确保 target 类型已提前定义
        // Targets []target
    }

    // 再定义 config（引用方）
    type config struct {
        Interval     int    `mapstructure:"Interval"`
        StatsdPrefix string `mapstructure:"statsd_prefix"`
        Groups       []group `mapstructure:"groups"` // 此时 group 已可见
    }

    // 示例实例化（可选）
    cfg := config{
        Interval:     30,
        StatsdPrefix: "app.metrics",
        Groups: []group{{
            Group:        "backend",
            TargetPrefix: "service.backend",
        }},
    }
}

⚠️ 注意事项：

• 此限制仅适用于函数内定义的类型（即局部类型别名/结构体）。若将类型定义在包级（全局作用域），则可通过相互引用（借助指针或接口）实现循环依赖，但函数内不支持。
• 若 group 中还需引用 target，必须同样保证 target 在 group 之前声明，或改用指针（如 *target）缓解（但 target 仍需存在）。
• 推荐实践：对于复杂嵌套配置，优先使用包级类型定义，提升可读性、复用性与测试友好度；函数内定义应限于简单、一次性使用的类型。

总结：Go 的类型声明顺序即作用域边界。牢记“先定义，后使用”，是避免此类 undefined 错误的关键原则。