GORM 的查询方法（如 Limit、Where、Select）均返回新的 *gorm.DB 实例，而非原地修改；若忽略其返回值，后续操作将作用于未更新的旧查询对象，导致 Limit 等条件失效。

gorm 的查询方法（如 `limit`、`where`、`select`）均返回新的 `*gorm.db` 实例，而非原地修改；若忽略其返回值，后续操作将作用于未更新的旧查询对象，导致 `limit` 等条件失效。

在使用 GORM 构建动态查询时，一个常见误区是误以为调用 Limit()、Where() 等方法会直接修改当前 *gorm.DB 对象。实际上，GORM 的所有查询构造方法都是不可变（immutable）的：它们基于当前查询克隆一个新的 *gorm.DB 实例，并在其上应用新条件，然后返回该新实例。原始变量若未重新赋值，将保持不变。

因此，以下写法中 Limit(10) 的效果被丢弃：

selectQuery := db.Select("username").Where("status = 'active'")
selectQuery.Limit(10) // ❌ 错误：返回的新查询未被接收，原 selectQuery 未变
if err := selectQuery.Find(&users).Error; err != nil {
    // Limit 并未生效！实际执行的是无 Limit 的查询
}

✅ 正确做法是显式接收并复用返回值：

selectQuery := db.Select("username").Where("status = 'active'")
selectQuery = selectQuery.Limit(10) // ✅ 正确：将带 Limit 的新查询赋值回变量
if err := selectQuery.Find(&users).Error; err != nil {
    log.Fatal(err)
} else {
    fmt.Printf("Found %d active users\n", len(users))
}

更推荐的写法是链式调用（简洁且不易出错）：

if err := db.Select("username").
    Where("status = ?", "active"). // ✅ 使用参数化防止 SQL 注入
    Limit(10).
    Find(&users).Error; err != nil {
    log.Fatal(err)
}

? 关键注意事项：

• 所有 GORM 查询构造方法（Select, Where, Order, Limit, Offset, Joins, Scopes 等）均返回新 *gorm.DB，必须接收；
• 条件拼接顺序不影响 SQL 逻辑，但建议 Where 在 Limit 前，语义更清晰；
• 动态条件可结合 if 判断灵活追加，每次都要赋值：

  query := db.Model(&User{})
  if status != "" {
      query = query.Where("status = ?", status)
  }
  if nameContains != "" {
      query = query.Where("username LIKE ?", "%"+nameContains+"%")
  }
  query = query.Limit(20)
  query.Find(&users)

总结：GORM 的链式 API 设计强调函数式风格——每一次调用都产生新查询。理解并遵循“接收返回值”这一原则，是写出可靠、可维护 GORM 查询代码的基础。