必须手动判断参数有效性再拼接where条件，避免空字符串、零值、nil等误入sql；推荐用切片累积条件+strings.join拼接，并动态处理in子句占位符。
WHERE 条件拼接前先判断参数是否有效
Go 里没有“SQL 模板自动忽略空值”这种魔法，WHERE 条件拼接必须手动控制逻辑分支。核心原则是：**不把空字符串、零值、nil 切片直接塞进 SQL**，否则可能查出意外数据（比如 name = '' 或 status = 0 本意是“不限”，结果变成强制过滤）。
常见错误现象：SELECT * FROM user WHERE name = ? AND status = ?，但传入 name="" 和 status=0，导致查不到任何记录；或者用 fmt.Sprintf 拼接时没做判空，生成了 AND created_at > '' 这种语法错误。
- 用
len()判切片/字符串是否为空，用!= nil判指针或接口，用!reflect.ValueOf(v).IsZero()谨慎处理泛型场景（一般不推荐） - 对数字类型（如
int、int64），不能只看是否为0—— 需要额外字段标记“是否启用该条件”，比如statusFilter *int，用指针区分“未设置”和“设为 0” - 时间字段优先用
*time.Time，避免传入零值time.Time{}被误认为有效条件
用 slice 累积条件 + strings.Join 拼接 WHERE 子句
这是最可控、最易读的拼接方式，避免字符串反复拼接或嵌套 if。关键点在于：**条件子句和对应参数分开维护，最后统一绑定**。
使用场景：需要支持多种可选筛选项（如后台列表页搜索），且需兼容 MySQL/PostgreSQL 等不同驱动（它们对占位符处理一致）。
- 声明两个 slice：
var conditions []string存 SQL 片段（如"status = ?"），var args []interface{}存对应值 - 每个参数检查后，只在满足条件时才
append对应的conditions和args，例如：if name != "" { conditions = append(conditions, "name LIKE ?"); args = append(args, "%"+name+"%") } - 拼
WHERE时用strings.Join(conditions, " AND ")，如果len(conditions) == 0就不加WHERE，避免语法错误
用 sqlx.NamedExec 或 database/sql 原生方式处理命名参数
如果你用的是结构体传参（比如 filter struct{ Name string; Status int }），sqlx 的命名查询能减少手动顺序管理参数的出错概率，但**它不会自动跳过零值字段**——仍需预处理。
性能影响：命名参数解析比位置参数略慢（微乎其微），但可读性和维护性提升明显；兼容性上，sqlx 依赖底层 database/sql 驱动，MySQL/PostgreSQL 都支持良好。
-
sqlx.NamedExec要求 SQL 中用:name语法，但必须确保结构体字段已导出（首字母大写），且 tag 正确，例如type Filter struct { Name string `db:"name"` } - 仍需在调用前清理结构体：可写一个
func (f *Filter) ToQuery() (string, []interface{})方法，内部做判空+生成条件 - 不要直接把整个结构体传给
NamedExec并指望它“智能忽略空字段”——它会把所有字段都当参数绑定，包括""和0
警惕 IN (?) 动态长度参数绑定
当需要拼 IN 条件（如查多个 ID），不能写成 "id IN (?)" 然后传入 []int{1,2,3} —— database/sql 不支持 slice 自动展开，会报错 sql: converting argument $1 type: unsupported type []int, a slice of int。
正确做法是动态生成占位符，再展开 slice 参数。容易踩的坑是 SQL 注入（千万别用 fmt.Sprintf 拼 ID 列表）和参数数量超限（MySQL 默认 max_allowed_packet 影响）。
- 用
make([]string, len(ids))生成等长?切片，再strings.Join(placeholders, ",")拼成"?, ?, ?" - 用
args = append(args, ids...)展开参数，确保类型一致（如全为interface{}） - 如果
ids为空切片，整个IN条件应跳过，否则生成id IN ()语法错误
动态拼 WHERE 最麻烦的不是语法，而是“哪些值算‘未设置’”。字符串、数字、时间、布尔、切片各自的零值语义完全不同，靠一个 == 0 或 == "" 很难覆盖所有业务含义。多花半分钟想清楚每个字段的“空”代表什么，比后期 debug 十次都管用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
