Go语言中结构体嵌套Map的初始化与数据填充问题

刚接触Go的话，嵌套Map确实容易踩坑——核心问题几乎都是Map未初始化导致的，毕竟Go里声明的Map字段默认是nil，直接往里面塞数据会触发运行时panic。我结合你的结构体，给你一步步讲怎么正确填充：

先明确核心问题 #

你的EpicFeatureStory里，Features是一个map，它的value又是包含Stories（另一个map）的结构体。如果直接创建结构体实例后就往Features里加数据，或者没初始化内层的Stories，都会报错。

正确的填充步骤&代码示例 #

首先你的结构体定义没问题：

type EpicFeatureStory struct {
    Key         string
    Description string
    Features    map[string]struct {
        Name        string
        Description string
        Stories     map[string]struct {
            Name        string
            Description string
        }
    }
}

接下来分两步处理：

1. 初始化外层Map #

创建EpicFeatureStory实例时，一定要先把Features用make()初始化：

// 初始化结构体，同时创建外层Features Map
epic := EpicFeatureStory{
    Key:         "EPIC-001",
    Description: "用户中心需求",
    Features:    make(map[string]struct {
        Name        string
        Description string
        Stories     map[string]struct {
            Name        string
            Description string
        }
    }),
}

2. 遍历数据并填充（含内层Map初始化） #

假设你已经从REST接口反序列化得到了原始的features数据（比如一个临时的map），遍历的时候要记得给每个feature的Stories也初始化：

// 示例：从接口反序列化得到的原始features数据
rawFeatures := map[string]map[string]interface{}{
    "FEAT-001": {
        "name":        "用户注册",
        "description": "支持手机号/邮箱注册",
        "stories": map[string]map[string]string{
            "STORY-001": {"name": "手机号校验", "description": "实现手机号格式验证逻辑"},
            "STORY-002": {"name": "密码加密", "description": "存储用户密码的加密处理"},
        },
    },
    "FEAT-002": {
        "name":        "用户登录",
        "description": "支持多端登录态同步",
        "stories": map[string]map[string]string{
            "STORY-003": {"name": "Token生成", "description": "生成JWT令牌返回给客户端"},
        },
    },
}

// 遍历原始数据，填充到epic.Features中
for featKey, featInfo := range rawFeatures {
    // 先创建当前feature的结构体，同时初始化内层的Stories Map
    currentFeature := struct {
        Name        string
        Description string
        Stories     map[string]struct {
            Name        string
            Description string
        }
    }{
        Name:        featInfo["name"].(string),
        Description: featInfo["description"].(string),
        Stories:     make(map[string]struct {
            Name        string
            Description string
        }),
    }

    // 填充当前feature下的stories
    if rawStories, ok := featInfo["stories"].(map[string]map[string]string); ok {
        for storyKey, storyInfo := range rawStories {
            currentFeature.Stories[storyKey] = struct {
                Name        string
                Description string
            }{
                Name:        storyInfo["name"],
                Description: storyInfo["description"],
            }
        }
    }

    // 将当前feature存入外层的Features Map
    epic.Features[featKey] = currentFeature
}

常见错误排查 #

如果还是遇到问题，先检查这几点：

• 是不是忘记用make()初始化Features或者Stories？如果报错assignment to entry in nil map，百分百是这个原因。
• 类型断言是不是出错了？反序列化后的类型可能和你预期的不一样，建议用ok模式（比如上面的if rawStories, ok := ...）避免panic。
• 打印结构体看看：用fmt.Printf("%#v", epic)输出完整结构体，确认Map是不是已经被正确初始化。

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