必须替换驱动为github.com/lib/pq并下划线导入，DSN改用postgres://格式且必含sslmode=disable和timezone，结构体标签需适配serial主键、text/jsonb类型，Engine初始化时驱动名填"postgres"并用Sync2同步表。
要在Go项目中用XORM连接PostgreSQL而非MySQL，必须替换驱动、调整DSN格式、处理时区与类型映射差异，否则会报“driver: unknown driver postgresql”或“pq: unrecognized parameter”错误。
替换数据库驱动并导入
安装PostgreSQL专用驱动：执行 go get github.com/lib/pq，不能复用MySQL的 github.com/go-sql-driver/mysql。
代码中必须用下划线导入驱动： _ "github.com/lib/pq"，否则NewEngine会因未注册驱动而panic。
这一步漏掉驱动导入是初学者最常踩的坑——编译不报错，运行时才提示“unknown driver postgresql”。
构造正确的PostgreSQL连接字符串（DSN）
PostgreSQL的DSN不支持MySQL那种 user:pass@tcp(host:port)/db?param 形式。
必须改用URL格式： postgres://用户名:密码@主机:端口/数据库名?sslmode=disable&timezone=UTC。
【sslmode=disable 是关键前提】 本地开发不配SSL证书时若省略此项，连接将被拒绝；生产环境需根据实际配置 sslmode=verify-full 或 require。
timezone参数强烈建议显式指定，否则PostgreSQL可能按服务器本地时区解析time.Time，导致Carbon时间字段入库偏移。
适配PostgreSQL特有类型与行为
方法一：结构体标签中避免MySQL专属类型声明
MySQL常用 xorm:"varchar(255) notnull"，PostgreSQL应改用通用类型如 xorm:"text notnull" 或 xorm:"varchar(255)"——PostgreSQL对varchar长度限制不如MySQL严格，但超长插入仍会报错。
方法二：主键自增需显式声明serial
MySQL用 xorm:"pk autoincr" 即可，PostgreSQL必须写成 xorm:"pk serial"，否则Sync()建表后id字段无默认值且无法自动递增。
方法三：处理JSON字段兼容性
PostgreSQL原生支持jsonb类型，可直接声明 Data string `xorm:"jsonb"`；MySQL需用text+手动序列化，此处无需改动，但若跨库迁移需注意字段定义不可直接复用。
验证连接与同步表结构
第一步：创建Engine实例
调用 xorm.NewEngine("postgres", dsn)，第一个参数必须是字符串 "postgres"，不是 "postgresql" 或 "pg"，否则初始化失败。
第二步：启用SQL日志观察底层行为
在engine创建后立即执行 engine.ShowSQL(true)，运行Sync()时能清晰看到XORM生成的是CREATE TABLE ... SERIAL还是SERIAL8，确认是否命中PostgreSQL语法。
第三步：执行表结构同步
调用 engine.Sync2(new(User))，注意使用Sync2而非Sync——Sync2会先检查表是否存在，避免重复建表报错；PostgreSQL对已存在表的ALTER操作比MySQL更敏感，这步容错更稳。
