2. GORM 环境搭建与基础配置

在开始使用 GORM 进行数据库操作之前，需要完成 Go 语言开发环境、GORM 库以及对应数据库驱动的安装与配置。本章将按照标准流程，逐步搭建一个可运行的 GORM 开发环境，并验证基础连接是否成功。

2.1 Go 语言环境准备

GORM 是基于 Go 语言的 ORM 框架，因此首先需要安装 Go 编译器与运行时环境。建议使用 Go 1.18 及以上版本，以支持泛型等现代特性。

2.2 初始化项目模块

创建一个新的项目目录，并使用 go mod init 初始化模块。模块名建议使用有意义的命名空间，例如 gorm-smoke-test。

mkdir gorm-smoke-test
cd gorm-smoke-test
go mod init gorm-smoke-test

执行完成后，项目根目录下会生成 go.mod 文件，内容类似：

module gorm-smoke-test

go 1.22.0

2.3 安装 GORM 核心库

GORM 核心库提供了 ORM 的核心功能，包括模型定义、CRUD 操作、关联查询、钩子函数等。使用 go get 命令安装最新稳定版本：

go get -u gorm.io/gorm

安装完成后，go.mod 文件会自动添加依赖记录：

require (
    gorm.io/gorm v1.25.12
)

2.4 安装数据库驱动

GORM 支持多种数据库后端，每种数据库需要安装对应的驱动。驱动负责实现数据库底层的网络协议与连接管理。以下是三种主流数据库驱动的安装方式：

2.5 数据库连接配置

安装完驱动后，需要编写数据库连接代码。GORM 使用 gorm.Open 函数建立连接，该函数接收驱动实例和配置参数。以下是三种数据库的连接示例：

2.5.1 MySQL 连接

package main

import (
    "gorm.io/driver/mysql"
    "gorm.io/gorm"
)

func main() {
    dsn := "user:password@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
    db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
    if err != nil {
        panic("failed to connect database")
    }
    // db 可用
}

2.5.2 PostgreSQL 连接

package main

import (
    "gorm.io/driver/postgres"
    "gorm.io/gorm"
)

func main() {
    dsn := "host=localhost user=gorm password=gorm dbname=gorm port=5432 sslmode=disable TimeZone=Asia/Shanghai"
    db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
    if err != nil {
        panic("failed to connect database")
    }
}

2.5.3 SQLite 连接

package main

import (
    "gorm.io/driver/sqlite"
    "gorm.io/gorm"
)

func main() {
    db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
    if err != nil {
        panic("failed to connect database")
    }
}

2.6 连接配置参数详解

gorm.Config 结构体提供了丰富的连接配置选项，以下是最常用的配置项：

2.7 环境搭建流程总览

以下 SVG 图展示了从 Go 环境检查到数据库连接验证的完整搭建流程：

2.8 连接验证与冒烟测试

完成连接配置后，建议编写一个简单的冒烟测试脚本，验证数据库连接是否正常。以下是一个通用的验证示例：

package main

import (
    "fmt"
    "gorm.io/driver/mysql"
    "gorm.io/gorm"
)

func main() {
    dsn := "root:root@tcp(127.0.0.1:3306)/test?charset=utf8mb4&parseTime=True&loc=Local"
    db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
    if err != nil {
        fmt.Printf("连接失败: %v\n", err)
        return
    }

    // 获取底层 sql.DB 对象
    sqlDB, err := db.DB()
    if err != nil {
        fmt.Printf("获取 sql.DB 失败: %v\n", err)
        return
    }

    // Ping 测试
    err = sqlDB.Ping()
    if err != nil {
        fmt.Printf("Ping 失败: %v\n", err)
        return
    }

    fmt.Println("数据库连接成功！")
}

2.9 常见连接问题排查