Date: 11/11/2026Category: GoWind风行Tag: Golang, GoWind, Protobuf, ent, 数据库
本文回答一个问题:一个实体主键的类型怎么在五层(proto / ent / SQL / Go / 前端)之间保持一致,「ID 是 64 位有符号整数」这条口径如何穿透到 TypeScript 与 Dart,而「容量、计数」这类同样是无符号语义的字段又怎么和 ID 划清界限?
GoWind Admin 与 GoWind CMS 采用同一套全链 ID 口径:ID 一律 64 位有符号整数(int64),在 proto3 JSON 下序列化为字符串,前端全链以 string 承载。这套口径同时定死了三件事:哪些字段是 ID、ID 在线上的形态、前端见到的类型。这篇把这三件事拆开,逐层给出真实定义与边界处的语义陷阱。
