Go语言连接MySQL数据库（手把手教你使用 github.com/go-sql-driver/mysql）

一、准备工作

在开始之前，请确保你已经安装了以下工具：

• Go 语言环境（建议 1.16 或更高版本）
• MySQL 数据库（本地或远程均可）
• 一个代码编辑器（如 VS Code）

二、安装 go-sql-driver/mysql

打开终端，进入你的 Go 项目目录，运行以下命令来安装驱动：

go get -u github.com/go-sql-driver/mysql

这个命令会自动下载并安装 go-sql-driver/mysql 包到你的项目依赖中。

三、连接 MySQL 数据库

Go 语言标准库中的 database/sql 提供了统一的数据库操作接口，而 go-sql-driver/mysql 则是它的 MySQL 实现。我们通过以下步骤连接数据库：

1. 导入必要的包
2. 构建 DSN（Data Source Name）连接字符串
3. 调用 sql.Open() 打开连接
4. 测试连接是否成功

下面是一个完整的连接示例：

package mainimport (	"database/sql"	"fmt"	_ "github.com/go-sql-driver/mysql" // 注意：这里使用匿名导入)func main() {	// 构建 DSN：用户名:密码@tcp(地址:端口)/数据库名	dsn := "root:123456@tcp(127.0.0.1:3306)/testdb"	// 打开数据库连接	db, err := sql.Open("mysql", dsn)	if err != nil {		panic(err)	}	defer db.Close()	// 测试连接	err = db.Ping()	if err != nil {		fmt.Println("连接失败:", err)	} else {		fmt.Println("✅ 成功连接到 MySQL 数据库！")	}}

注意：导入驱动时使用的是 _ "github.com/go-sql-driver/mysql"，这是因为我们不需要直接调用该包的函数，而是通过 database/sql 接口间接使用它。下划线表示“匿名导入”，仅用于触发包的初始化函数。

四、执行 SQL 查询与操作

连接成功后，你可以执行查询（SELECT）、插入（INSERT）、更新（UPDATE）和删除（DELETE）等操作。

1. 查询单条记录

var name stringerr := db.QueryRow("SELECT name FROM users WHERE id = ?", 1).Scan(&name)if err != nil {	fmt.Println("查询失败:", err)} else {	fmt.Println("用户姓名:", name)}

2. 插入数据

result, err := db.Exec("INSERT INTO users (name, email) VALUES (?, ?)", "张三", "zhangsan@example.com")if err != nil {	fmt.Println("插入失败:", err)} else {	id, _ := result.LastInsertId()	fmt.Println("新用户ID:", id)}

五、常见问题与注意事项

• DSN 格式错误：确保用户名、密码、主机、端口和数据库名正确无误。
• 时区问题：可在 DSN 中添加 ?parseTime=true&loc=Asia%2FShanghai 来处理时间类型和时区。
• 连接池管理：Go 的 sql.DB 是并发安全的，并自带连接池，无需手动管理连接。

六、总结

通过本教程，你已经学会了如何在 Go 语言中使用 github.com/go-sql-driver/mysql 驱动连接和操作 MySQL 数据库。这是 Go 开发中非常基础且重要的技能。无论你是构建 Web 应用、微服务还是数据处理工具，掌握这一技术都将大有裨益。

记住关键词：Go语言、MySQL驱动、go-sql-driver/mysql 和 数据库连接，它们是你深入学习 Go 数据库编程的关键。

现在，快去动手试试吧！祝你编码愉快！🎉