2. GORM 安装与配置：Go 环境准备、GORM 包引入、数据库驱动选择与 DSN 连接字符串配置

在开始使用 GORM 进行数据库迁移与异步错误码断言之前，必须完成开发环境的搭建与核心依赖的配置。本章将系统性地讲解从 Go 语言环境准备到 GORM 包引入、数据库驱动选择以及 DSN 连接字符串配置的完整流程，确保你能够快速搭建一个可运行的 GORM 开发环境。

2.1 Go 语言环境准备

GORM 是基于 Go 语言的 ORM 框架，因此首先需要安装并配置 Go 开发环境。以下是环境准备的关键步骤与版本要求：

完成 Go 安装后，建议设置 GOPROXY 以加速模块下载：

go env -w GOPROXY=https://goproxy.cn,direct
go env -w GO111MODULE=on

2.2 初始化项目与引入 GORM 包

使用 Go Modules 初始化项目，并引入 GORM 核心包。以下是标准操作流程：

1. 创建项目目录并初始化模块：

mkdir gorm-migration-course
cd gorm-migration-course
go mod init gorm-migration-course

2. 安装 GORM 核心包：

go get -u gorm.io/gorm

3. 安装数据库驱动（以 MySQL 为例）：

go get -u gorm.io/driver/mysql

2.3 数据库驱动选择与对比

GORM 官方支持多种数据库驱动，不同驱动在性能、功能与配置上存在差异。下表列出了三种最常用的驱动及其适用场景：

2.4 DSN 连接字符串配置详解

DSN（Data Source Name）是数据库连接的核心配置字符串，GORM 通过 DSN 解析连接参数。不同数据库的 DSN 格式差异较大，以下是各数据库的详细配置说明：

MySQL DSN 格式

username:password@protocol(address)/dbname?param1=value1&param2=value2

常用参数说明：

完整示例：

dsn := "root:mysecret@tcp(127.0.0.1:3306)/gorm_demo?charset=utf8mb4&parseTime=True&loc=Local"

PostgreSQL DSN 格式

host=localhost user=user password=pass dbname=dbname port=5432 sslmode=disable TimeZone=Asia/Shanghai

SQLite DSN 格式

test.db  // 相对路径或绝对路径

2.5 完整连接示例与验证

以下代码展示了如何使用 GORM 连接 MySQL 数据库并验证连接是否成功：

package main

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

func main() {
    dsn := "root:mysecret@tcp(127.0.0.1:3306)/gorm_demo?charset=utf8mb4&parseTime=True&loc=Local"
    db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
    if err != nil {
        panic("数据库连接失败: " + err.Error())
    }

    // 获取底层 sql.DB 对象并 Ping 验证
    sqlDB, err := db.DB()
    if err != nil {
        panic("获取 sql.DB 失败: " + err.Error())
    }

    err = sqlDB.Ping()
    if err != nil {
        panic("数据库 Ping 失败: " + err.Error())
    }

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

2.6 GORM 配置项与连接池设置

GORM 的 gorm.Config 结构体提供了丰富的配置选项，用于控制日志、命名策略、事务行为等。同时，通过 sql.DB 可以设置连接池参数：

db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{
    SkipDefaultTransaction: true,   // 跳过默认事务以提升性能
    NamingStrategy: schema.NamingStrategy{
        TablePrefix:   "t_",        // 表名前缀
        SingularTable: true,        // 使用单数表名
    },
    Logger: logger.Default.LogMode(logger.Info), // 日志级别
})

// 设置连接池
sqlDB, _ := db.DB()
sqlDB.SetMaxIdleConns(10)           // 最大空闲连接数
sqlDB.SetMaxOpenConns(100)          // 最大打开连接数
sqlDB.SetConnMaxLifetime(time.Hour) // 连接最大复用时间

2.7 环境配置架构总览

下图展示了从 Go 环境到 GORM 连接数据库的完整配置链路：

2.8 多数据库驱动切换策略

在实际项目中，可能需要根据环境（开发/测试/生产）切换数据库类型。推荐使用环境变量或配置文件实现驱动与 DSN 的动态选择：

import (
    "os"
    "gorm.io/gorm"
    "gorm.io/driver/mysql"
    "gorm.io/driver/postgres"
    "gorm.io/driver/sqlite"
)

func NewDB() (*gorm.DB, error) {
    dbType := os.Getenv("DB_TYPE")
    dsn := os.Getenv("DB_DSN")

    var dialector gorm.Dialector
    switch dbType {
    case "mysql":
        dialector = mysql.Open(dsn)
    case "postgres":
        dialector = postgres.Open(dsn)
    case "sqlite":
        dialector = sqlite.Open(dsn)
    default:
        return nil, fmt.Errorf("不支持的数据库类型: %s", dbType)
    }

    return gorm.Open(dialector, &gorm.Config{})
}

通过以上步骤，你已经完成了 GORM 开发环境的完整搭建与配置。下一阶段将进入数据库迁移的核心内容——模型定义与自动迁移。