使用pgx/v5时sqlc生成pgtypes而非Go类型的正确用法与配置

1. 当前用法的正确性 #

你手动构造pgtype.Text、pgtype.Numeric结构体的方式是正确的——pgx的pgtype类型是为了精准映射PostgreSQL的类型语义（比如处理NULL值、特殊数值精度）设计的，这种写法完全符合pgx的设计逻辑，但确实存在冗余繁琐的问题。

2. 更简洁的pgtype使用方式 #

不用手动构造结构体，pgtype类型提供了Set方法可以直接从Go标准类型转换：

• 字符串类型示例：

  var owner pgtype.Text
  owner.Set("Craigs List") // 自动设置String和Valid字段
  

• 整数类型示例：

  var limit pgtype.Int4
  limit.Set(int32(10))
  

• 数值类型（numeric）可以用pgtype.Numeric的Set方法接收big.Rat或者直接解析字符串：

  var num pgtype.Numeric
  // 从字符串解析
  num.SetString("-543.000")
  // 或者从big.Rat转换
  num.Set(big.NewRat(-543, 1000))
  

3. 配置sqlc生成Go标准类型 #

你完全可以通过sqlc的配置文件实现这一点，这并非不合理——如果你的业务场景中字段不会为NULL，或者可以接受用零值代替NULL，这种配置是完全可行的。

在sqlc.yaml中添加类型覆盖规则：

version: "2"
sql:
  - schema: "path/to/schema.sql"
    queries: "path/to/queries.sql"
    engine: "postgresql"
    gen:
      go:
        out: "internal/db"
        overrides:
          # 映射PostgreSQL text到Go string
          - db_type: "text"
            go_type: "string"
          # 映射int4到int32
          - db_type: "int4"
            go_type: "int32"
          # 映射numeric到float64（根据业务需求，也可以用big.Rat）
          - db_type: "numeric"
            go_type: "float64"
          # 其他需要覆盖的类型同理

配置后，sqlc生成的结构体就会直接使用Go标准类型，无需手动处理pgtype。

注意：如果字段可能为NULL，使用标准类型会导致sqlc生成的代码在处理NULL值时panic，这种场景下还是建议使用pgtype类型来保证类型安全。

内容的提问来源于stack exchange，提问作者KarlsMaranjs