脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 脚本专栏 → Golang → Go Gorm

Go Gorm 示例详解

 更新时间：2025年01月16日 09:41:09   作者：米饭好好吃.  
Gorm是一款高性能的Golang ORM库,便于开发人员提高效率,本文介绍了Gorm的基本概念、数据库连接、基本操作（创建表、新增记录、查询记录、修改记录、删除记录）等,本文介绍Go Gorm的相关知识,感兴趣的朋友一起看看吧

1. 概念

Gorm 官网：https://gorm.io/zh_CN/docs/

Gorm：The fantastic ORM library for Golang aims to be developer friendly，这是官网的介绍，简单来说 Gorm 就是一款高性能的 Golang ORM 库，便于开发人员提高效率

那么 ORM（Object Relation Mapping） 又是什么呢？在 Golang 语言中，Object指的就是 struct 结构体对象，Relation 就是数据库当中的关系，Mapping则表示两者具有映射关系，具体表现如下：

  • Go当中的结构体声明 <-> 数据库层面的表结构
  • Go当中的结构体实例 <-> 数据库层面的一条表记录

2. 数据库连接

2.1 安装依赖

想要在 Go 代码中使用 gorm 我们需要先引入对应的依赖：

  • gorm 库依赖：gorm.io/gorm
  • 特定数据库驱动依赖：gorm.io/driver/mysql

然后使用 go mod 包管理工具加载对应的依赖：

go mod init first_gorm：初始化

go mod tidy：加载依赖

然后就可以开始编写代码了！

2.2 连接数据库

在操作数据库之前，我们还需要与指定的数据库建立连接，此处以 MySQL数据库为例：

基本语法：db, err := gorm.Open(mysql.Open(dsn语句), &gorm.Config{})

其中 dsn 语句为特定的连接格式，形式如下：user:pwd@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local

package main
import (
	"fmt"
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
func main() {
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test?charset=utf8mb4&parseTime=True&loc=Local"
	db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	if err != nil {
		fmt.Println("数据库连接失败!", err)
	}
	fmt.Println(db)
}

程序运行结果：

控制台打印出 db 对象，说明我们已经成功与数据库建立连接（必须保证数据库中存在指定的数据库）

3. 数据库基本操作

3.1 创建表（表关系映射）

3.1.1 基本使用

我们可以使用 gorm 提供的 API 来创建指定的表，需要关注的是 结构体声明 <=> 数据库表结构，因此我们想要创建一个表结构实则只需要定义一个结构体类型

-- 创建user表 --
create table t_user (
  user_id bigint primary key auto_increment,
  user_name varchar(32) not null,
  user_pwd varchar(128) not null,
  user_phone varchar(32) unique
)

使用上述 SQL 语句创建表的行为等价于在 Go 语言当中定义下列结构体对象：

// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}

创建表基本语法：err := db.AutoMigrate(&特定结构体{})

package main
import (
    "fmt"
    "gorm.io/driver/mysql"
    "gorm.io/gorm"
)
// User 结构体声明
type User struct {
    UserId    int64  `gorm:"primaryKey;autoIncrement"`
    UserName  string `gorm:"not null;type:varchar(32)"`
    UserPwd   string `gorm:"not null;type:varchar(128)"`
    UserPhone string `gorm:"unique;type:varchar(32)"`
}
func main() {
    // 连接数据库
    var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test?charset=utf8mb4&parseTime=True&loc=Local"
    db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
    if err != nil {
        fmt.Println("数据库连接失败!", err)
    }
    err = db.AutoMigrate(&User{})
    if err != nil {
        fmt.Println("数据库表迁移失败!", err)
    }
}

程序运行结果：

3.1.2 自定义表名

我们发现定义结构体名称为 “User” 时会创建 “users” 的表名，但是如果我就希望叫做 “t_user” 应该怎么办呢？我们可以定义一个名为 TableName的方法接收器，格式如下：

func (*User) TableName() string {
	return "t_user"
}

删除原先的表后再次运行，可以发现此时表名称已经指定为t_user了

3.2 新增记录

我们还可以使用 gorm 提供的 API 进行表记录的插入，这里我们需要关注** 结构体实例 <=> 表记录** 之间的映射关系，也就意味着我们可以通过创建一个结构体实例，实现插入一条记录的效果

3.2.1 单条数据插入

基本语法：db.Create(&结构体实例)

package main
import (
	"fmt"
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test?charset=utf8mb4&parseTime=True&loc=Local"
	db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	if err != nil {
		fmt.Println("数据库连接失败!", err)
	}
	// 插入单条数据
	var user = User{UserName: "wjj", UserPwd: "123", UserPhone: "111"}
	db.Create(&user)
	// 再次打印user
	fmt.Println(user)
}

数据库表结果：

程序运行结果：

💡 提示：从中我们还可以发现，插入数据之后，还会将数据库表中记录回显到结构体实例当中！这也是为什么需要传递地址的原因！

3.2.2 批量插入数据

当我们需要批量插入多条数据的时候，循环调用 db.Create(&结构体实例)这个方法效率就太低了！因为数据库连接会话频繁创建销毁耗时比较高，更合适的方法就是进行批量插入

基本语法：db.Create(&结构体实例切片)，仍旧是 Create 函数，但是参数我们可以传递结构体实例切片

package main
import (
	"fmt"
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test"
	db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	// 批量插入多条数据
	var users = []User{
		{UserName: "th", UserPwd: "123", UserPhone: "222"},
		{UserName: "lhf", UserPwd: "123", UserPhone: "333"},
		{UserName: "zcy", UserPwd: "123", UserPhone: "444"},
	}
	db.Create(&users)
	// 打印结果
	fmt.Println(users)
}

数据库表结果：

程序运行结果：

3.3 查询记录

3.3.1 查询所有记录

基本语法：db.Find(&结构体实例切片)

package main
import (
	"fmt"
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test"
	db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	// 查询全部记录
	var users []User
	db.Find(&users)
	// 打印结果
	fmt.Println(users)
}

程序运行结果：

3.3.2 按照条件查询

我们可以使用 Where 指定查询条件进行过滤

基本语法：db.Where("user_id > ?", 2).Find()表示想要查询 user_id > 2 的所有记录

package main
import (
	"fmt"
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test"
	db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	// 按照条件查询
	var users []User
	db.Where("user_id > ?", 2).Find(&users)
	// 打印
	fmt.Println(users)
}

程序运行结果：

3.3.3 查询单条记录

查询单条记录有以下两种情况：

  • 查询第一条记录：db.First(&结构体实例)
  • ​​​​​​​查询最后一条记录：db.Last(&结构体实例)
package main
import (
	"fmt"
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test"
	db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	// 查询第一条记录
	var firstUser User
	db.First(&firstUser)
	// 查询最后一条记录
	var lastUser User
	db.Last(&lastUser)
	fmt.Println(firstUser, lastUser)
}

程序运行结果：

3.3.4 查询记录总数

基本语法：db.Find(&结构体实例切片).Count(&整型变量)

package main
import (
	"fmt"
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test"
	db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	// 查询总数
	var users []User
	var totalSize int64
	db.Find(&users).Count(&totalSize)
	fmt.Println("记录总数:", totalSize)
}

程序运行结果：

3.4 修改记录

3.4.1 按照默认主键修改

基本语法：db.Save(&结构体实例)会按照结构体实例当中的主键字段找到对应数据库记录进行修改

package main
import (
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test"
	db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	// 查询user_id为1的记录
	var stu User
	db.Where("user_id = ?", 1).Find(&stu)
	// 修改stu姓名为wjj1
	stu.UserName = "wjj1"
	// 修改(按照主键修改)
	db.Save(&stu)
}

程序运行结果：

3.4.2 修改指定字段

上述按照默认主键修改的方式修改了全部字段，如果我们只想修改特定单个字段可以使用以下方式：

基本语法：db.Model(&结构体实例).Where(条件).Update(字段, 修改值)

package main
import (
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test"
	db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	// 修改user_id为1的记录 user_name为wjj
	var stu User
	db.Model(&stu).Where("user_id = ?", 1).Update("user_name", "wjj")
}

程序运行结果：

3.4.3 修改多个字段

我们还可以指定多个字段进行修改

基本语法：db.Model(&结构体实例).Where(条件).updates(修改实例)，其中修改实例可以是结构体也可以是map对象

package main
import (
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test"
	db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	// 修改user_id为1的记录 user_name为WJJ, user_pwd为"999"
	var stu User
	var fields = map[string]interface{}{"user_name": "WJJ", "user_pwd": "999"}
	db.Model(&stu).Where("user_id = ?", 1).Updates(fields)
}

程序运行结果：

3.5 删除记录

3.5.1 按照默认主键删除

基本语法：db.Delete(&结构体实例)会自动按照主键找到表中记录，然后删除

package main
import (
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test"
	db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	// 按照默认主键删除
	var user = User{UserId: 1}
	db.Delete(&user)
}

程序运行结果：

3.5.2 指定条件删除

我们想更加精细化的控制删除条件就需要借助 Where 函数：

基本语法：db.Where(条件).Delete(&结构体实例)

package main
import (
	"gorm.io/driver/mysql"
	"gorm.io/gorm"
)
// User 结构体声明
type User struct {
	UserId    int64  `gorm:"primaryKey;autoIncrement"`
	UserName  string `gorm:"not null;type:varchar(32)"`
	UserPwd   string `gorm:"not null;type:varchar(128)"`
	UserPhone string `gorm:"unique;type:varchar(32)"`
}
func (*User) TableName() string {
	return "t_user"
}
func main() {
	// 连接数据库
	var dsn = "root:QWEzxc123456@tcp(127.0.0.1:3306)/gorm_test"
	db, _ := gorm.Open(mysql.Open(dsn), &gorm.Config{})
	// 按照条件删除
	db.Where("user_id = ?", 10).Delete(&User{})
}

程序运行结果：

到此这篇关于Go Gorm 详解的文章就介绍到这了,更多相关Go Gorm 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • Go语言使用net/http实现简单登录验证和文件上传功能

    Go语言使用net/http实现简单登录验证和文件上传功能

    这篇文章主要介绍了Go语言使用net/http实现简单登录验证和文件上传功能,使用net/http模块编写了一个简单的登录验证和文件上传的功能，在此做个简单记录，需要的朋友可以参考下
    2023-07-07
  • Go语言使用漏桶算法和令牌桶算法来实现API限流

    Go语言使用漏桶算法和令牌桶算法来实现API限流

    为防止服务器被过多的请求压垮,限流是一个至关重要的技术手段,下面我们就来看看如何使用漏桶算法和令牌桶算法来实现 API 的限流吧
    2024-11-11
  • Go语言中的方法定义用法分析

    Go语言中的方法定义用法分析

    这篇文章主要介绍了Go语言中的方法定义用法,实例分析了方法的定义及使用技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-02-02
  • Go如何在HTTP请求中操作cookie教程详解

    Go如何在HTTP请求中操作cookie教程详解

    这篇文章主要为大家介绍了Go如何在HTTP请求中操作cookie教程详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2024-01-01
  • 利用golang的字符串解决leetcode翻转字符串里的单词

    利用golang的字符串解决leetcode翻转字符串里的单词

    这篇文章主要介绍了利用golang的字符串解决leetcode翻转字符串里的单词，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12
  • Go语言中实现打印堆栈的errors包的用法详解

    Go语言中实现打印堆栈的errors包的用法详解

    因为Go语言提供的错误太简单了，以至于简单的我们无法更好的处理问题，所以诞生了很多对错误处理的库，github.com/pkg/errors是比较简洁的一样，本文就来聊聊它的具体用法吧
    2023-07-07
  • Golang安全读写共享变量的方式详解

    Golang安全读写共享变量的方式详解

    互斥锁（Mutex）是一种常用的同步原语,用于防止多个协程同时访问共享资源,这篇文章主要介绍了Golang安全读写共享变量的方式,需要的朋友可以参考下
    2024-05-05
  • Go语言空接口与类型断言的完全指南

    Go语言空接口与类型断言的完全指南

    在 Go 语言中,interface{} 被称为空接口,它是 Go 泛型时代到来之前最灵活的万能容器,但把值装进去容易,拿出来时该如何安全地还原它的真实身份？这就是类型断言（Type Assertion）的用武之地,本文将带你彻底搞懂这对黄金搭档,需要的朋友可以参考下
    2026-05-05
  • 使用Go语言实现xmind文件转换为markdown

    使用Go语言实现xmind文件转换为markdown

    这篇文章主要来和大家一起深入探讨如何用Go语言构建一个强大的命令行工具,实现XMind到Markdown的无损转换,感兴趣的小伙伴可以跟随小编一起学习一下
    2025-06-06
  • Go语言编写一个简易聊天室服务端的实现

    Go语言编写一个简易聊天室服务端的实现

    本文介绍用Go语言构建TCP聊天室服务端,通过Goroutine实现多客户端并发通信,提供基础聊天功能,具有一定的参考价值,感兴趣的可以了解一下
    2025-08-08

最新评论