GORM v2中QueryFields模式是否会忽略Smart Select？

一、QueryFields 模式的核心含义 #

QueryFields: true 是GORM配置中的选项，它修改了默认的字段选择逻辑：

• 当未显式指定查询字段，且未通过Model()指定模型时，GORM会以传入Find方法的结构体作为模型，查询该结构体的所有字段。
• 对比默认模式（QueryFields=false）：默认情况下GORM会启用Smart Select，自动检测目标结构体的字段，仅查询能映射到目标结构体的列。

二、QueryFields 是否会覆盖Smart Select？ #

分两种场景判断：

1. 未指定Model的情况：
   开启QueryFields后，Smart Select的自动字段选择逻辑会被覆盖——GORM会直接查询传入结构体的所有字段，而非仅目标结构体需要的字段。
2. 显式指定Model的情况：
   Smart Select依然生效，GORM会根据目标结构体的字段去Model中匹配对应列，只查询这些匹配的字段，QueryFields不会影响这个逻辑。

三、两个Find查询的等价性判断 #

当QueryFields激活时，db.Find(&user)和db.Find(&apiUser)完全不等价：

• db.Find(&user)：以User作为模型，会查询User的所有字段（包括Age、Gender以及你提到的数百个其他字段）
• db.Find(&apiUser)：以APIUser作为模型，仅查询APIUser包含的ID、Name两个字段

四、指定Model后的查询结果确认 #

你给出的这段代码：

db.Model(&User{}).Limit(10).Find(&APIUser{})
// SELECT `id`, `name` FROM `users` LIMIT 10

执行结果是正确的。因为通过Model(&User{})指定了数据源模型为User，而目标结构体是APIUser，此时Smart Select逻辑正常工作，只会查询APIUser中存在的字段，QueryFields模式不会干扰这个过程。

内容的提问来源于stack exchange，提问作者Bryton Zheng