GORM 不自动转义含特殊符号的字段名，Order() 等方法需手动用反引号包裹（如 "user-name"），否则 SQL 报错；Preload 和 Count 也须同步处理，否则导致查询失败或结果不准。
GORM 本身不支持直接对含特殊符号（如连字符 -、点号 .、空格、中文等）的字段名做分页排序，因为这些字段在 SQL 中必须用反引号（`）包裹，而 GORM 的 Order() 方法默认不自动转义——你传 "user-name"，它就拼成 ORDER BY user-name，MySQL 直接报错 Unknown column 'user' in 'order clause'。
Order() 里字段名含连字符或空格会触发 SQL 解析错误
这是最常见的一线报错，尤其在迁移旧表或对接第三方数据库时。GORM 不会对字符串参数做 SQL 标识符转义，它把 Order("created-at DESC") 当作纯文本塞进 SQL，结果生成非法语法。
- 错误示例：
db.Order("user-name ASC").Limit(10).Offset(0).Find(&users)→ MySQL 报ERROR 1054 (42S22): Unknown column 'user' in 'order clause' - 正确写法：必须手动加反引号，写成
db.Order("`user-name` ASC")或db.Order("`created-at` DESC, `id` DESC") - 别依赖结构体 tag 映射：即使你定义了
UserName string `gorm:"column:user-name"`，Order()仍只认传入的字符串字面量，不会查 tag 自动补反引号 - 批量处理建议：封装一个辅助函数，比如
QuoteCol("user-name") → "`user-name`"，避免硬编码散落各处
Preload 关联字段含特殊符号时，分页前必须先查 ID 列表
如果要分页并预加载一个字段名为 order-items 的一对多关联，千万别写 Preload("OrderItems") 后直接 Limit/Offset——GORM 会先查出 10 条主记录，再为每条发一条 SELECT * FROM `order-items` WHERE order_id IN (?)。但注意：这个子查询的表名和字段名同样需要反引号，而 Preload 不会帮你加。
- 风险点：若没在
Preload前显式用Table("`order-items`")或自定义Joins，GORM 可能按驼峰规则转成order_items，导致查不到数据 - 安全做法：分两步——先用
SELECT id FROM users ... LIMIT 10 OFFSET 0拿到 ID 列表，再用db.Where("`order_id` IN ?", ids).Find(&items)批量查关联，字段和表名都手动加反引号 - 别在 Preload 里混用
Order：例如Preload("OrderItems", func(db *gorm.DB) *gorm.DB { return db.Order("`created-at` DESC") })是可行的，但必须确保`created-at`已被包裹
Count 查询时字段名未转义会导致总数不准或 panic
当你对含特殊符号字段做条件过滤（如 Where("`status-code` = ?", "active")）后调 Count()，如果没同步给排序字段加反引号，可能触发两个问题：一是 Count() 复用链上残留的 Order()，导致 SQL 语法错误；二是某些数据库驱动在解析失败时静默返回 0 而非报错。
- 典型错误链：
db.Where("`status-code` = ?", "active").Order("user-name DESC").Count(&total)→ORDER BY user-name在 COUNT 子句中非法 - 修复方式：Count 前清掉 Order，或显式重置：
db.Session(&gorm.Session{NewDB: true}).Model(&User{}).Where("`status-code` = ?", "active").Count(&total) - 更稳方案：手写子查询，把反引号控制权完全拿回来：
db.Raw("SELECT COUNT(*) FROM (`users` u JOIN `profiles` p ON u.id = p.user_id) WHERE u.`status-code` = ?", "active").Scan(&total)
字段名带特殊符号不是 GORM 的 bug，而是 SQL 标准要求——所有非标准标识符都得转义。最容易被忽略的是：Order、Where、Joins、Preload 的回调函数里，只要涉及字段或表名，就得自己加 `，GORM 不代劳。别指望“它应该懂”，一漏就是线上 SQL 报错。
