系统的币种怎么写？数据库、代码与设计规范全解析

在开发涉及支付、订单、账务或国际化业务的系统时，“币种”是绕不开的核心字段，很多开发者会问：系统的币种到底该怎么写？用中文、英文缩写还是数字代码？本文将从标准规范、数据库设计、代码实现三个层面,给出完整的答案。

币种写法的国际标准：ISO 4217

写币种之前，首先要了解 ISO 4217 货币编码标准，这是全球通用的货币表示规范,包含三种形式：

表示形式	示例	说明
字母代码	CNY、USD、EUR	3位大写字母，最常用
数字代码	156、840、978	3位数字，用于某些金融报文
货币符号	仅用于前端展示，不建议存储

推荐做法：系统内部统一使用 3 位字母代码（如人民币写 CNY，美元写 USD，日元写 JPY）,这是行业主流方案。

常见币种代码速查：

• CNY，人民币
• USD，美元
• EUR，欧元
• JPY，日元（注意无小数位）
• HKD，港币
• GBP，英镑

数据库中的币种字段怎么设计

字段类型与长度

CREATE TABLE `order` (
  `id` BIGINT PRIMARY KEY AUTO_INCREMENT,
  `amount` DECIMAL(18, 4) NOT NULL COMMENT '金额',
  `currency` CHAR(3) NOT NULL DEFAULT 'CNY' COMMENT '币种，ISO 4217'
);

设计要点：

• 类型选 CHAR(3)：币种代码固定 3 位，比 VARCHAR 更省空间且语义明确；
• 不要用货币符号存储：如 "$"、"¥"，无法区分同符号的不同货币（美元和加元符号都是 $）；
• 不要用中文名存储：“人民币”、“美元”不利于国际化,也无法与第三方接口对接。

是否需要币种字典表

如果系统支持多币种、且币种有扩展属性（符号、小数位数、启用状态）,建议建字典表：

CREATE TABLE `currency` (
  `code` CHAR(3) PRIMARY KEY COMMENT '币种代码',
  `name` VARCHAR(50) NOT NULL COMMENT '币种名称',
  `symbol` VARCHAR(10) COMMENT '货币符号',
  `scale` TINYINT DEFAULT 2 COMMENT '小数位数',
  `status` TINYINT DEFAULT 1 COMMENT '1启用 0停用'
);

代码中的币种怎么写

后端（以 Java 为例）

推荐定义枚举类,集中管理：

public enum CurrencyEnum {
    CNY("CNY", "人民币", 2),
    USD("USD", "美元", 2),
    JPY("JPY", "日元", 0);
    private final String code;
    private final String name;
    private final int scale;
    // 省略构造方法和getter
}

注意事项：

1. 金额计算不要用 double/float，存在精度丢失，应使用 BigDecimal；
2. 换算、比较时必须携带币种参数，100 CNY 和 100 USD 不是同一概念；
3. 保留小数位数要按币种处理，日元是 0 位小数，科威特第纳尔是 3 位小数。

前端展示

后端存储统一用字母代码,前端展示时再转换为符号或名称：

CNY → ¥100.00
USD → $100.00

这样存储与展示解耦,方便做多语言切换。

常见错误盘点

1. ❌ 币种字段留空或用 0 表示,无法对接支付渠道；
2. ❌ 用 VARCHAR(10) 且大小写混写（cny、CNY 并存）,建议统一大写并加校验；
3. ❌ 所有币种都按 2 位小数处理,日元等特殊币种会出错；
4. ❌ 单币种系统不存币种字段,后期国际化时改造成本极高。

系统的币种怎么写？记住三句话：

1. 存储统一用 ISO 4217 的 3 位大写字母代码（CHAR(3)）；
2. 代码中用枚举管理币种及其属性（小数位、符号）；
3. 展示层再转换为符号或名称,存储与显示分离。

即使当前业务只支持人民币，也建议从第一天就设计好币种字段，这是低成本、高回报的架构决策。