货币设置

📅 2026-11-21 👁️ 1

货币设置

货币设置用于定义商城展示和订单接口返回的货币名称、国际代码与符号。

入口路径

后台顶部菜单 →「设置」→「货币设置」。实际地址:/system/setting/currency,需要管理员权限(canAdmin)。

功能说明

页面只有一个设置表单,包含货币名称、国际代码和货币符号,保存后对商城前台和接口返回生效。

界面截图

货币设置

设置项说明

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
货币名称 后台与前台展示用的货币名称 文本,源码未注明默认值 [源码] 国内商城填「人民币」,外贸填「美元」 用于后台订单与财务展示
货币国际代码 标准三字母代码 如 CNY、USD、EUR [源码] 遵循 ISO 4217,按结算币种填写 接口返回给用户端,前端据此判断币种
货币符号 价格前显示的符号 如 ¥、$、€ [源码] 与币种对应,人民币 ¥、美元 $ 只改变展示,不会换算已有价格

配置项详解

货币符号字段的填写注意

出现条件:始终显示 [实测]。

源码中 CurrencyConfig 定义了 Name、Currency、Symbol 三个字段(config/setting.go:136-140),但前端页面的「货币国际代码」和「货币符号」两个输入框使用了相同的提交字段名,可能导致符号值覆盖代码值 [COMPUTED]。

建议:填写后到前台商品页与订单接口核对实际输出;若发现代码显示为符号,调整填写顺序或检查补丁版本。

填错后果:国际化商城可能出现币种识别错误。

操作步骤

  1. 进入「设置 → 货币设置」。
  2. 填写货币名称、国际代码和符号。
  3. 点击「提交」保存。
  4. 在商品详情页和订单接口中确认显示正确。

适用场景与建议

  • 国内商城:人民币 / CNY / ¥。
  • 外贸商城:按目标市场填写对应代码与符号,并确保模板价格格式化逻辑配合。

前台调用示例

订单相关接口会返回货币符号字段 currency_symbol,前端展示应以后端返回值为准,避免写死:

{% archiveSku productSku with id=1 %}
{{ productSku.Price }}
{% endarchiveSku %}

priceFormat 标签的符号来源即本页配置。

注意事项

  • 货币设置只改变展示符号,不会自动换算已有价格。切换货币前需自行调整商品价格。
  • 注意上述货币符号字段的提交字段名冲突,保存后务必在前台核对。
  • 商城模式需要在「全局设置 → 运行与 SEO 状态」中开启。

相关文档