GORM v1的Scope是func(gorm.DB) gorm.DB类型，用于封装通用查询逻辑，需显式调用；v2已废弃，改用Scopes方法接收同类型函数切片，支持链式叠加、闭包传参及与Preload/Count协同，更安全可靠。
什么是GORM查询作用域（Scope）
GORM的Scope是v1版本中用于封装通用查询逻辑的机制，它本质是一个函数类型func(*gorm.DB) *gorm.DB，接收一个*gorm.DB实例并返回改造后的实例。它不是v2中的Scopes（注意复数），也不是链式调用的预定义方法，而是开发者手动注入的可复用查询片段。
常见错误现象：把Scope当成v2的Scopes用，或误以为它能自动生效——它必须显式调用Apply()或通过Where()等方法间接触发（实际极少这么用）。
使用场景有限，典型如多租户隔离、软删除统一过滤、状态字段默认约束。
要点：
- v1专属，GORM v2已废弃
Scope，改用Scopes函数切片或func(db *gorm.DB) *gorm.DB直接传参 - 不能在
Model()之后直接接Scope；必须用db.Session(&gorm.Session{}).Scope(...)或更常见的db.Scopes(...)（v2） - 作用域内修改
db.Statement比拼SQL字符串更安全，但v1中Statement结构不稳定，容易因GORM内部变更失效
如何在GORM v2中正确使用Scopes替代旧Scope
GORM v2用Scopes方法替代了v1的Scope，接受一个或多个func(*gorm.DB) *gorm.DB函数。这是当前唯一推荐方式。
例如实现“只查启用状态”的作用域：
func WithEnabled(db *gorm.DB) *gorm.DB {
return db.Where("status = ?", "enabled")
}
// 使用
var users []User
db.Scopes(WithEnabled).Find(&users)
关键细节：
- 多个作用域可链式叠加：
db.Scopes(WithEnabled, WithNotDeleted, WithTenantID(123)) - 作用域函数里避免直接
return db.Table("...")，会覆盖前面的Model；应优先用db.Unscoped()或db.Clauses()做精细控制 - 若作用域需动态参数（如租户ID），必须闭包捕获，不能写成
func(db *gorm.DB, tenantID uint) *gorm.DB——Scopes只接受单参数函数
为什么Where条件放在Scope里比写在Find前更可靠
直接写db.Where("status = ?", "enabled").Find(&users)看似简单，但一旦逻辑分散到多个地方，就容易漏、难维护、难测试。
而作用域把约束收口为函数，带来三方面实际好处：
- 单元测试可独立验证：
result := WithEnabled(db.Session(&gorm.Session{DryRun: true})) + 检查生成SQL
- 与
Preload共用时行为确定：作用域在Preload前应用，不会污染关联查询的WHERE条件
- 配合
Count()自然生效：db.Scopes(WithEnabled).Model(&User{}).Count(&count)结果含过滤
result := WithEnabled(db.Session(&gorm.Session{DryRun: true})) + 检查生成SQLPreload共用时行为确定：作用域在Preload前应用，不会污染关联查询的WHERE条件Count()自然生效：db.Scopes(WithEnabled).Model(&User{}).Count(&count)结果含过滤容易踩的坑：
- 作用域里调用
db.First()或db.Create()会执行真实操作，破坏“纯查询修饰”语义 - 若作用域中用了
db.Table("other_table")，后续Preload可能找不到原始Model的表名，报invalid field found for struct
软删除场景下Scopes和Unscoped的协作关系
GORM默认对实现了gorm.DeletedAt字段的模型启用软删除，即所有Find/First自动加WHERE deleted_at IS NULL。但有时你需要“强制包含已软删记录”，又不想全局关掉软删除。
这时不要在作用域里写db.Unscoped()——它会彻底关闭软删除，连你自己加的status条件都可能被绕过。
正确做法是分层处理：
- 基础作用域（如
WithEnabled）只管业务状态，不碰deleted_at
- 需要查软删数据时，显式调用
db.Unscoped().Scopes(WithEnabled)，顺序不能反
- 若想“排除软删 + 额外条件”，直接用
db.Scopes(WithEnabled)即可，GORM已自动处理
WithEnabled）只管业务状态，不碰deleted_at
db.Unscoped().Scopes(WithEnabled)，顺序不能反db.Scopes(WithEnabled)即可，GORM已自动处理性能提示：多次调用Unscoped()无额外开销，但它会让索引失效（如果deleted_at有复合索引），线上慎用。
立即学习“go语言免费学习笔记（深入）”；
