2. Go 基础语法回顾：变量声明、基本数据类型、常量、iota枚举、字符串操作、fmt包格式化输出

在进入报表环境回放接口编排之前，必须夯实 Go 语言的基础语法。本章将系统回顾变量声明、基本数据类型、常量与 iota 枚举、字符串操作以及 fmt 包的格式化输出。这些知识点是后续编写接口编排逻辑、处理请求参数、构造响应数据的基石。

2.1 变量声明

Go 语言提供多种变量声明方式，适用于不同场景。下表总结了四种主要形式及其使用建议：

// 包级别变量
var apiVersion string = "v1"

func main() {
    // 短变量声明
    endpoint := "/api/replay"
    timeout := 30

    // 批量声明
    var (
        requestID string
        statusCode int
    )
    requestID = "req-001"
    statusCode = 200
}

2.2 基本数据类型

Go 是强类型语言，基本数据类型分为四大类。在报表回放接口中，这些类型直接对应请求/响应字段：

2.3 常量与 iota 枚举

常量使用 const 关键字声明，编译期确定值。iota 是常量计数器，用于生成枚举值序列，在接口编排中常用于定义状态码、环境类型等。

const (
    // 报表环境类型枚举
    EnvDev  = iota // 0
    EnvTest        // 1
    EnvStaging     // 2
    EnvProd        // 3
)

const (
    // 回放状态枚举，跳过 iota 默认值
    StatusPending = iota + 1 // 1
    StatusRunning            // 2
    StatusCompleted          // 3
    StatusFailed             // 4
)

2.4 字符串操作

Go 字符串为不可变字节序列，标准库 strings 包提供丰富操作函数。在接口编排中，字符串用于拼接 URL、解析路径参数、处理 JSON 字段名等。

import "strings"

func buildReplayURL(env, endpoint string) string {
    // 拼接完整回放接口 URL
    base := "https://replay." + strings.ToLower(env) + ".example.com"
    return base + strings.TrimRight(endpoint, "/")
}

func parseEnvFromPath(path string) string {
    parts := strings.Split(path, "/")
    if len(parts) >= 2 {
        return parts[1] // 例如 "/prod/replay" → "prod"
    }
    return "unknown"
}

2.5 fmt 包格式化输出

fmt 包是 Go 中最常用的格式化 I/O 包。在接口编排中，主要用于日志输出、错误信息构造和调试。下表列出核心格式化动词：

import "fmt"

type ReplayRequest struct {
    Env     string
    Timeout int
}

func main() {
    req := ReplayRequest{Env: "staging", Timeout: 30}

    // 日志输出
    fmt.Printf("回放请求: %+v\n", req)
    // 输出: 回放请求: {Env:staging Timeout:30}

    // 构造错误信息
    errMsg := fmt.Sprintf("环境 %s 超时 %d 秒", req.Env, req.Timeout)
    fmt.Println(errMsg)
    // 输出: 环境 staging 超时 30 秒

    // 调试类型
    fmt.Printf("类型: %T, 值: %v\n", req.Timeout, req.Timeout)
    // 输出: 类型: int, 值: 30
}