在 Go ORM 开发中，需区分“未设置字段”与“显式设为零值”，避免将合法空字符串、零整数误判为 NULL；推荐使用 sql.NullString 等类型配合 Valid 字段显式标记有效性。
在 go orm 开发中，需区分“未设置字段”与“显式设为零值”，避免将合法空字符串、零整数误判为 null；推荐使用 `sql.nullstring` 等类型配合 `valid` 字段显式标记有效性。
在构建轻量级 ORM 时，一个常见痛点是：Go 结构体字段默认初始化为零值（如 string 为 ""，int64 为 0，bool 为 false），而这些零值在数据库中往往对应 NULL（表示“未提供”），而非业务意义上的有效值（例如用户名可为空字符串，但 ID 为 0 可能是非法状态）。若直接通过 reflect 遍历所有字段并插入，会导致 SQL 中出现 INSERT INTO user (...) VALUES ("", 0, ...)，既语义不清，又可能违反 NOT NULL 约束或触发意外默认值。
正确做法是显式建模“可空性”：不依赖零值隐含语义，而是用类型系统表达意图。标准库 database/sql 提供了 sql.NullString、sql.NullInt64、sql.NullBool 等类型，它们均包含两个字段：
type NullString struct {
String string
Valid bool // true 表示值有效（非 NULL）；false 表示该字段应写入 NULL
}将其应用于结构体，即可清晰区分“未设置”与“设为空”：
type User struct {
ID int64
Username string
Password string
Email sql.NullString // 可为空；未赋值时 Valid=false，String=""
Comment sql.NullString
}初始化时，只需按需设置 Valid 标志：
u := User{
Username: "user_0001",
Password: "password",
Email: sql.NullString{
String: "test@example.com",
Valid: true,
},
// Comment 保持默认值：{String: "", Valid: false} → 对应 SQL NULL
}在生成 INSERT 语句时，遍历字段并检查 Valid 即可精准决定是否包含该列：
// 伪代码示意：仅对 Valid==true 的 sql.Null* 字段及非零值基础类型（需按业务规则判断）生成列
if email, ok := field.Interface().(sql.NullString); ok {
if email.Valid {
columns = append(columns, "email")
values = append(values, fmt.Sprintf("'%s'", escape(email.String)))
}
// else: 跳过，数据库将填入 NULL
}⚠️ 注意事项：
- sql.NullString 不实现 fmt.Stringer，直接 fmt.Println(s) 会输出 {Value Valid} 结构体内容，应访问 s.String 获取字符串值；
- JSON 序列化需自定义 MarshalJSON/UnmarshalJSON 方法（或使用第三方库如 guregu/null）；
- 指针方案（如 *string）虽更灵活，但需频繁解引用且易引发 panic，sql.Null* 类型语义更明确、安全性更高；
- 关键原则：零值 ≠ NULL，必须由开发者显式声明 Valid = true 才代表“此字段已提供有效值”。
综上，通过 sql.Null* 类型替代原生基础类型，将“空值语义”从隐式零值提升为显式状态机，是 Go 数据库交互中兼顾类型安全、可读性与可靠性的最佳实践。
