Pop 的 scope 是需显式传入执行函数的查询构建器，非模型方法；必须手动注入 pop.All 等函数的第二个参数，不可直接链式调用；不支持上下文依赖，须提前提取参数闭包传入；应为无状态纯函数，Eager 路径需合并避免冗余 JOIN。
Pop 的 scope 是 pop.Query 类型的函数，本质是可组合的查询构建器，不是模型方法或全局注册项。Buffalo 项目里用它，关键在「什么时候传、怎么链、谁负责 cleanup」。
Scope 必须显式传给 pop.Find / pop.All 等执行函数
很多人误以为 scope 可以像 Rails 的 class method 那样直接调用，比如 User.WithPosts().All() —— 这在 Pop 里不成立。WithPosts 如果是个 scope 函数，它只返回 pop.Query，必须手动塞进 pop.All 或 pop.Find 的第二个参数里：
func WithPosts(q *pop.Query) *pop.Query {
return q.Eager("Posts")
}
// ✅ 正确：scope 作为参数传入
users, err := tx.All(&users, WithPosts)
// ❌ 错误：WithPosts() 不会自动作用于 All()
users, err := tx.All(&users) // WithPosts 完全没生效
- scope 函数本身不触发查询，只是构造 query 链，漏传就等于没写
- 所有带
pop.Query参数的执行方法（All、First、Count、Paginate）都支持 scope 注入 - 多个 scope 可用
pop.And或手动链式调用：WithPosts(WithActive(q))
Scope 里不能直接访问 buffalo.Context 或 session
scope 是纯数据层函数，运行在 pop.Connection 上下文里，没有 buffalo.Context、没有 c.Param()、也没有 session 数据。想根据当前用户过滤？得把值从 handler 里提前提取出来，再闭包进 scope：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
// ❌ 错误：scope 内部试图读 c
func ForCurrentUser(c buffalo.Context) pop.Query {
uid := c.Param("user_id") // 编译失败：c 未定义
return func(q *pop.Query) *pop.Query {
return q.Where("user_id = ?", uid)
}
}
// ✅ 正确：值由 handler 提前传入
func ForUserID(uid int) pop.Query {
return func(q *pop.Query) *pop.Query {
return q.Where("user_id = ?", uid)
}
}
// 在 handler 中使用
uid := c.Param("user_id")
users, _ := tx.All(&u, ForUserID(uid))
- scope 必须是无状态、可复用、可测试的纯函数
- 任何依赖运行时上下文的逻辑（如权限、租户 ID、请求头）都得在调用前 resolve 并传入
- 别在 scope 里做日志、panic、HTTP 重定向等副作用操作
Scope 组合时注意 eager 加载的嵌套层级
Eager 类 scope 在组合时容易因多次调用导致 SQL JOIN 重复或 N+1 回归。例如 Eager("Posts.Comments") 和 Eager("Posts.Tags") 分开调用，可能生成两个独立 JOIN，而非一个合并的三表 JOIN：
// ⚠️ 危险：分开调用可能触发冗余 JOIN
q1 := Eager("Posts.Comments")(q)
q2 := Eager("Posts.Tags")(q1) // Pop 不保证自动合并，取决于底层 dialect
// ✅ 推荐：单次声明完整 eager 路径
q := Eager("Posts.Comments", "Posts.Tags")(q)
- Pop 的
Eager不是 lazy 加载，而是预编译 JOIN 条件，路径越深，SQL 越复杂 - 多个
Eager调用不等价于一个带多个参数的Eager，尤其涉及同一关联多次时 - 调试时用
tx.Q().Debug().All(&v)查看实际生成的 SQL，别只信 scope 名字
