4. Go 核心数据结构：数组、切片、映射、结构体、指针、接口

在报表回放系统中，数据结构的选型直接决定了内存占用、并发安全性和代码可维护性。本章从 Go 的六大核心数据结构出发，结合报表环境中的实际场景，逐一剖析其底层原理与工程落地要点。

4.1 数组（Array）—— 固定长度的连续内存块

数组是 Go 中最基础的数据结构，长度固定，元素类型一致，存储在连续内存中。在报表系统中，数组常用于存储固定数量的配置项或预分配的缓冲区。

// 报表月度数据：固定12个月
var monthlySales [12]float64
monthlySales[0] = 12345.67

// 传参时复制整个数组（不推荐大数组）
func processArray(arr [12]float64) {
    // arr 是原数组的副本
}

4.2 切片（Slice）—— 动态数组的工程利器

切片是 Go 中最常用的数据结构，它是对数组的抽象封装，支持动态扩容。在报表回放中，切片用于存储不定长的数据行、日志流和中间计算结果。

4.2.1 切片底层结构

切片由三部分组成：指向底层数组的指针、长度（len）和容量（cap）。理解这三者的关系是避免内存泄漏和性能问题的关键。

4.2.2 切片扩容机制

当 append 操作超出容量时，Go 会分配一个新的底层数组，并将原数据复制过去。扩容策略在 Go 1.18+ 中有所调整：

• 容量小于 256：扩容为原来的 2 倍
• 容量大于等于 256：扩容因子为 (cap + 3*256) / 4，增长趋缓
• 大切片：每次扩容约增加 25% 容量

// 切片扩容示例
s := make([]int, 0, 2)
s = append(s, 1, 2)   // len=2, cap=2
s = append(s, 3)      // 触发扩容，新 cap=4，分配新底层数组
s = append(s, 4, 5)   // 再次扩容，新 cap=8

// 报表场景：动态追加数据行
type ReportRow struct {
    Date   string
    Value  float64
}
rows := make([]ReportRow, 0, 1000) // 预分配减少扩容次数

4.3 映射（Map）—— 键值对的高效查找

映射是 Go 中实现关联数组的内置类型，底层基于哈希表。在报表回放中，map 常用于数据分组、去重和缓存。

4.3.1 Map 底层原理

Go 的 map 使用拉链法解决哈希冲突，每个桶（bucket）可以存储 8 个键值对，溢出时通过链表连接额外桶。

// 报表数据分组：按部门聚合
type DepartmentReport struct {
    DeptName string
    Total    float64
    Count    int
}

deptMap := make(map[string]*DepartmentReport)
deptMap["技术部"] = &DepartmentReport{DeptName: "技术部", Total: 0, Count: 0}

// 安全读取
if report, ok := deptMap["技术部"]; ok {
    report.Total += 15000.0
    report.Count++
}

// 遍历（顺序随机）
for key, val := range deptMap {
    fmt.Printf("部门: %s, 总额: %.2f\n", key, val.Total)
}

4.4 结构体（Struct）—— 数据聚合的基石

结构体是 Go 中用于组合不同类型数据的复合类型。在报表系统中，几乎所有的业务实体都通过结构体定义。

4.4.1 结构体定义与标签

// 报表配置结构体
type ReportConfig struct {
    ReportID   string  `json:"report_id" yaml:"report_id"`
    Title      string  `json:"title"`
    Period     string  `json:"period"`       // 日报/周报/月报
    DataSource string  `json:"data_source"`
    CacheTTL   int     `json:"cache_ttl"`    // 缓存时间（秒）
    IsActive   bool    `json:"is_active"`
}

// 报表数据行
type ReportDataRow struct {
    Date      string    `json:"date"`
    Category  string    `json:"category"`
    Value     float64   `json:"value"`
    Metadata  map[string]interface{} `json:"metadata,omitempty"`
}

4.4.2 值接收者 vs 指针接收者

4.5 指针（Pointer）—— 引用传递与共享

指针存储变量的内存地址，在 Go 中通过 & 取地址，* 解引用。报表系统中，指针用于避免大结构体复制、实现共享状态和修改接收者。

// 指针在报表中的典型用法
type ReportEngine struct {
    config  *ReportConfig   // 共享配置，避免复制
    cache   map[string]*ReportDataRow  // 指针映射，避免值复制
}

func (e *ReportEngine) ProcessRow(row *ReportDataRow) {
    // 直接修改原始数据，无需返回值
    row.Value *= 1.1  // 上浮10%
}

// nil 指针检查
if row == nil {
    log.Warn("收到空数据行，跳过处理")
    return
}

4.6 接口（Interface）—— 抽象与多态

接口定义了一组方法签名，实现隐式满足。在报表回放架构中，接口是解耦组件、实现策略模式和依赖注入的核心工具。

4.6.1 接口定义与实现

// 报表数据源接口
type DataSource interface {
    Fetch(params map[string]interface{}) ([]ReportDataRow, error)
    Name() string
}

// CSV 数据源实现
type CSVDataSource struct {
    FilePath string
}

func (c *CSVDataSource) Fetch(params map[string]interface{}) ([]ReportDataRow, error) {
    // 读取 CSV 文件并解析
    return rows, nil
}

func (c *CSVDataSource) Name() string {
    return "CSV"
}

// 数据库数据源实现
type DBDataSource struct {
    DSN string
}

func (d *DBDataSource) Fetch(params map[string]interface{}) ([]ReportDataRow, error) {
    // 执行 SQL 查询
    return rows, nil
}

func (d *DBDataSource) Name() string {
    return "Database"
}

4.6.2 空接口与类型断言

空接口 interface{}（Go 1.18+ 可用 any）可以存储任意类型，在报表系统中常用于处理不确定类型的元数据。

// 报表元数据：支持任意类型
type ReportMeta struct {
    Key   string
    Value interface{}
}

meta := ReportMeta{Key: "version", Value: "2.1.0"}

// 类型断言
if v, ok := meta.Value.(string); ok {
    fmt.Println("版本号:", v)
}

// 类型 switch
switch val := meta.Value.(type) {
case string:
    fmt.Println("字符串:", val)
case float64:
    fmt.Println("浮点数:", val)
case int:
    fmt.Println("整数:", val)
default:
    fmt.Println("未知类型")
}

4.7 数据结构选型决策矩阵

在报表回放工程中，根据具体场景选择合适的数据结构，可以显著提升性能和可维护性。