Gorm Model FindFirstWhere等查询函数的区别

gorm是一款优秀的国产golang orm关系型数据库框架，在国内外使用比较广泛。它的链式调用还算是一种符合人类思维的风格。

不过在使用过程中也遇到一些困扰，比如：Model, Find, First, Where这些函数该什么时候使用，有时候会有边界不清楚，使用混乱的情况。

以下代码示例使用v2版本，v1和v2大体上相同，有些细微的不同

Where和Find


search := User{UserName:"月盾"}db.Find(&user, search)// SELECT * FROM `user` WHERE `user`.`user_name` = '月盾'db.Where(search).Find(&user)// SELECT * FROM `user` WHERE `user`.`user_name` = '月盾'

以上两种查询方式结果一样。

Find(dest interface{}, conds ...interface{})Find函数有两个参数，dest是数据接收者，conds是查询条件。所以Find也是可以代替Where来传入条件的。

Where的参数主要分为两类：String，Struct&Map。还有其他不常用类型。

String参数

当使用string参数时，使用方式类似于fmt.Printf，第一个参数为字符串格式，使用?作为占位符，后面的参数作为值。

Struct&Map参数

使用结构体和映射作为参数时，则推荐一个参数即可，struct和map本身就是键值对格式。否则容易引起混淆。比如这样的：


db.Where(&User{Name: "jinzhu"}, "name", "Age").Find(&users)// SELECT * FROM users WHERE name = "jinzhu" AND age = 0;db.Where(&User{Name: "jinzhu"}, "Age").Find(&users)// SELECT * FROM users WHERE age = 0;

注意当使用结构作为条件查询时，GORM 只会查询非零值字段。这意味着如果您的字段值为 0、’’、false 或其他零值，该字段不会被用于构建查询条件，例如：


db.Where(&User{Name: "jinzhu", Age: 0}).Find(&users)// SELECT * FROM users WHERE name = "jinzhu";

你可以使用 map 来构建查询条件，它会使用所有的值，例如：


db.Where(map[string]interface{}{"Name": "jinzhu", "Age": 0}).Find(&users)// SELECT * FROM users WHERE name = "jinzhu" AND age = 0;

Find和First


db.Find(&user)// SELECT * FROM `user`db.First(&user)// SELECT * FROM `user` ORDER BY `user`.`id` LIMIT 1

Find查询结果是列表，First查询的是单条数据。

First(dest interface{}, conds ...interface{})First参数和Find一样，同样可以传递条件参数。

Find和Scan


db.Raw("select * from user where id=?", 1).Find(&user)db.Raw("select * from user where id=?", 1).Scan(&user)

在使用Raw自定义SQL查询时，使用Scan来接收数据，虽然Find也是可以接收的，但是Find主要还是用来带条件查询的，链接到Raw后面时条件是不起作用的。所以用Scan函数单纯的接收数据就行了。

Model()函数什么时候用？

对于查询来说，一般使用Find，First就够了。当查询链中没有用到Find，First等函数时，这时就无法指定要查询的表了，此时就要用Model来指定表。

另外的场景就是更新操作中使用。

Update(column string, value interface{})

更新函数的参数是(字段，值)，没有能够确定表的参数，所以更新操作需要用到Model。

举例：

db.Model(&User{ID: 1}).Updates(User{Mobile: "13333333333"})

此时使用Model不仅可以指定表，还可以指定查询条件，但是这个条件却只能是id，不能使用其他条件。

像这样是不行的：

db.Model(&User{UserName: "月盾"}).Updates(User{Mobile: "13333333333"})

所以要使用其他条件就要用到Where函数了。

函数顺序

官网文档的示例中展示的例子都是这种格式：


db.Where("user_name = ?", "月盾").Find(&users)// SELECT * FROM users WHERE user_name = '月盾';

你可能会想，Where和Find函数的顺序可以调换吗？答案是：不能！

对于Find函数，他的单词意义是：查找。很容易让人理解成SQL中的select，这确实是一个误导，实际上应该理解成to或destination，可以解释为：将前面的查询结果输出到某个地方。

至于其他函数则可以调换位置，如：


db.Where("user_name = ?", "月盾").Order("id desc").Find(&user)db.Order("id desc").Where("user_name = ?", "月盾").Find(&user)// SELECT * FROM `user` WHERE user_name = '月盾' ORDER BY id desc

Where和Order的顺序则不影响最终输出SQL。

gorm目前有两个大版本：v1和v2，它们的差异可以查看官网文档[

GORM 2.0 发布说明

](https://gorm.io/zh_CN/docs/v2_release_note.html)

原文：https://www.yuedun.wang/2021/07/gorm-model-find-first/