3. Go基础语法回顾

在开始构建 REST API 之前，扎实的 Go 语言基础是高效开发与调试的保障。本章将系统回顾 Go 的核心语法要素，重点聚焦于变量与常量的声明、数据类型体系、控制结构、函数定义以及 Go 独特的错误处理模式。这些知识点将贯穿后续的接口开发与测试环节。

3.1 变量与常量

Go 语言采用静态类型系统，变量声明方式灵活，支持类型推断。常量则使用 const 关键字定义，编译期确定值。

变量声明

常量与 iota

常量使用 const 声明，支持 iota 枚举生成器，常用于定义一组递增的整型常量。

const (
    StatusPending = iota // 0
    StatusActive        // 1
    StatusInactive      // 2
    StatusDeleted       // 3
)

const Pi = 3.14159

3.2 数据类型体系

Go 的数据类型分为基础类型、复合类型与引用类型。理解类型的内存布局与零值机制，是避免空指针和类型转换错误的关键。

基础类型概览

复合类型：数组与切片

数组长度固定，切片则是对底层数组的动态视图，是 Go 中最常用的序列类型。

// 数组：长度固定
var arr [3]int = [3]int{1, 2, 3}

// 切片：动态长度
slice := []int{1, 2, 3}
slice = append(slice, 4) // 追加元素

复合类型：结构体与映射

结构体用于聚合不同字段，映射提供键值对查找，两者在 API 数据建模中频繁使用。

// 结构体定义
type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

// 映射声明与初始化
headers := map[string]string{
    "Content-Type": "application/json",
}

3.3 控制结构

Go 的控制结构简洁，仅保留 if、for、switch，去掉了 while 和 do-while。所有控制语句的条件表达式不需要括号包裹。

条件分支

// if 支持初始化语句
if err := validate(req); err != nil {
    return err
}

// switch 默认带 break，无需显式写
switch method {
case "GET":
    handleGet()
case "POST":
    handlePost()
default:
    http.Error(w, "Method not allowed", 405)
}

循环结构

Go 只有 for 关键字，但可以模拟多种循环模式。

3.4 函数与错误处理

函数是 Go 代码组织的基本单元。Go 支持多返回值，且将错误作为返回值显式传递，这是其错误处理哲学的核心。

函数定义与多返回值

// 多返回值：正常结果 + 错误
func Divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, errors.New("division by zero")
    }
    return a / b, nil
}

// 命名返回值：自动初始化零值，return 时无需指定变量
func ParseID(s string) (id int, err error) {
    id, err = strconv.Atoi(s)
    return
}

错误处理模式

Go 没有异常机制，错误通过 error 接口值传递。调用者必须显式检查错误，避免忽略潜在故障。

result, err := Divide(10, 0)
if err != nil {
    log.Printf("计算失败: %v", err)
    return
}
fmt.Println("结果:", result)

defer 延迟执行

defer 用于注册延迟调用，在函数返回前执行，常用于资源清理、关闭连接、解锁等操作。

func ReadFile(path string) ([]byte, error) {
    f, err := os.Open(path)
    if err != nil {
        return nil, err
    }
    defer f.Close() // 确保文件关闭

    return io.ReadAll(f)
}

3.5 语法要素关系图

下图展示了 Go 基础语法要素之间的组织关系，帮助理解变量、类型、控制流与函数如何协同构成程序骨架。

3.6 常见错误模式与避坑指南

在 REST API 开发中，以下语法层面的错误模式频繁出现，提前识别可大幅减少调试时间。

3.7 函数与错误处理流程

下图展示了 Go 函数调用中错误处理的典型流程，强调“尽早返回错误”的设计模式。