货币设置
货币设置
货币设置用于定义商城展示和订单接口返回的货币名称、国际代码与符号。
入口路径
后台顶部菜单 →「设置」→「货币设置」。实际地址:/system/setting/currency,需要管理员权限(canAdmin)。
功能说明
页面只有一个设置表单,包含货币名称、国际代码和货币符号,保存后对商城前台和接口返回生效。
界面截图

设置项说明
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 货币名称 | 后台与前台展示用的货币名称 | 文本,源码未注明默认值 [源码] | 国内商城填「人民币」,外贸填「美元」 | 用于后台订单与财务展示 |
| 货币国际代码 | 标准三字母代码 | 如 CNY、USD、EUR [源码] |
遵循 ISO 4217,按结算币种填写 | 接口返回给用户端,前端据此判断币种 |
| 货币符号 | 价格前显示的符号 | 如 ¥、$、€ [源码] |
与币种对应,人民币 ¥、美元 $ |
只改变展示,不会换算已有价格 |
配置项详解
货币符号字段的填写注意
出现条件:始终显示 [实测]。
源码中 CurrencyConfig 定义了 Name、Currency、Symbol 三个字段(config/setting.go:136-140),但前端页面的「货币国际代码」和「货币符号」两个输入框使用了相同的提交字段名,可能导致符号值覆盖代码值 [COMPUTED]。
建议:填写后到前台商品页与订单接口核对实际输出;若发现代码显示为符号,调整填写顺序或检查补丁版本。
填错后果:国际化商城可能出现币种识别错误。
操作步骤
- 进入「设置 → 货币设置」。
- 填写货币名称、国际代码和符号。
- 点击「提交」保存。
- 在商品详情页和订单接口中确认显示正确。
适用场景与建议
- 国内商城:人民币 /
CNY/¥。 - 外贸商城:按目标市场填写对应代码与符号,并确保模板价格格式化逻辑配合。
前台调用示例
订单相关接口会返回货币符号字段 currency_symbol,前端展示应以后端返回值为准,避免写死:
{% archiveSku productSku with id=1 %}
{{ productSku.Price }}
{% endarchiveSku %}
priceFormat 标签的符号来源即本页配置。
注意事项
- 货币设置只改变展示符号,不会自动换算已有价格。切换货币前需自行调整商品价格。
- 注意上述货币符号字段的提交字段名冲突,保存后务必在前台核对。
- 商城模式需要在「全局设置 → 运行与 SEO 状态」中开启。