本文档用于统一描述系统中常见的数据类型定义，适用于 接口文档、数据库设计、前后端对接。
基础数据类型
| 类型 | 说明 | 示例值 | 备注 |
|---|
| int | 整数类型，不带小数 | 1, -5, 100 | 32 位常用 |
| long | 长整型 | 9223372036854775807 | 64 位 |
| float | 单精度浮点数 | 3.14, -0.01 | 精度有限 |
| double | 双精度浮点数 | 3.1415926535 | 科学计算常用 |
| decimal | 高精度十进制数（金融场景） | 123.45m | 避免精度丢失 |
| bool | 布尔类型 | true, false | JSON 原生支持 |
| string | 字符串，文本类型 | "hello", "张三" | JSON 必须使用双引号 |
| char | 单个字符 | 'a', '中' | 多用于 C / Java |
| byte | 字节类型（8 位整数） | 0x1F, 255 | 二进制处理 |
复合数据类型
| 类型 | 说明 | 示例值 | 备注 |
|---|
| object | 对象类型，键值结构 | { "name": "Tom", "age": 18 } | JSON 原生 |
| array | 数组，有序集合 | [1, 2, 3], ["a", "b"] | JSON 原生 |
| map / dict | 键值对集合 | { "a": 1, "b": 2 } | 不同语言名称不同 |
时间与特殊类型
| 类型 | 说明 | 示例值 | 备注 |
|---|
| date | 日期（无时间） | "2026-06-16" | 推荐 |
| datetime | 日期 + 时间 | "2026-06-16 14:30:00" | |
| timestamp | 时间戳（秒/毫秒） | 1768764600 | 系统内部 |
| ISO8601 | 国际标准时间 | "2026-06-16T14:30:00+08:00" | ✅ 推荐 |
| UUID | 唯一标识符（32位 hex） | "9ee387a7e6da153b239862a768876cde" | 去横杠 |
JSON 类型对应关系（重要）
| 业务类型 | JSON 实际类型 | 推荐写法 |
|---|
| 整数 | number | 123 |
| 小数 | number | 3.14 |
| 金额 | string | "99.99" |
| 布尔 | boolean | true |
| 日期 | string | "2026-06-16" |
| ID | string | "9ee387a7e6da153b239862a768876cde" |
使用建议
接口字段统一使用 string 表示 ID、日期、金额
时间字段优先使用 ISO8601
避免在 JSON 中使用 int 表示日期（如 20260615）
金额字段避免使用 float / double
你好，世界。