【免费下载链接】whisper-moneyUnderstand your personal finances. Forget Excels, try Whisper Money.项目地址https://gitcode.com/gh_mirrors/wh/whisper-money点击查看免费下载Whisper Money 是一款开源的个人财务管理工具帮你告别 Excel 表格记账。它的多币种管理功能是核心卖点之一每个账户美元银行卡、欧元信用卡、比特币钱包各自保留自己的账户币种而仪表盘和各项分析则统一换算成你选定的主显示币种。这篇指南带你看懂 Whisper Money 多币种管理的正确打开方式账户币种、主显示币种、汇率转换三层机制让多币种数据始终一笔不错。一、先分清两个“币种”账户币种 vs 主显示币种 Whisper Money 的多币种模型只有两层分清它们能避免 90% 的困惑概念存哪里作用账户币种每个账户和交易上的currency_code该账户真实记账的“原币”主显示币种primary用户资料上的currency_code仪表盘、现金流、所有分析的汇总展示币种两者完全独立一位以 CNY 为主显示币种的用户可以同时持有 USD 银行账户和 BTC 钱包打开仪表盘看到的是统一的 CNY 总额。账户与交易各自携带币种app/Models/Account.php、app/Models/Transaction.php主显示币种跟着用户走app/Models/User.php设置主显示币种在设置 → 账户资料页面有 Currency 下拉框可选项由后端的primaryOptions()提供。系统还会根据你的 format locale如zh-CN、en-US的地域部分推荐一个默认币种推荐逻辑见 app/Services/CurrencyOptions.php。为每个账户选择币种新建账户时同样有一个币种下拉框可选项来自accountOptions()。注意部分币种只能当账户币种、不能当主显示币种——典型如 BTC它能持有、能展示但不适合作为全局汇总口径。能力区分由配置中的allows_primary/allows_account两个独立开关控制见 config/currencies.php。主显示币种生效的地方凡是“跨账户汇总”的视图都会先按当日汇率把各账户折算成主显示币种例如月度总结报告二、汇率转换是如何工作的按交易日期取价而不是今天核心原则历史余额用历史汇率这是最容易误解的一点。Whisper Money 转换一笔交易时取的是交易发生当天的汇率而不是“最新汇率”。这样你的历史余额曲线不会因为汇率波动而失真。转换入口app/Services/ExchangeRateService.php汇率来源与抓取app/Services/CurrencyConversionService.php数据来源、回退与缓存策略主数据源fawazahmed0/currency-api的每日汇率文件另备一个备用源自动切换历史回退某天没有汇率时最多向前回溯 7 天取最近的可用日分级缓存最新汇率缓存 6 小时历史汇率不可变缓存 30 天源不可用时只缓存 10 分钟以便快速恢复见 app/Services/CurrencyConversionService.php落库复用拉到的汇率会写入exchange_rates表供后续请求复用建表迁移见 database/migrations/2026_02_20_074846_create_exchange_rates_table.php。找不到汇率时怎么办系统会优雅降级而不是报错convert()返回未换算的金额并记录 warning保证总额仍然对得上需要严格区分的场景则用convertOrNull()返回 null见 app/Services/ExchangeRateService.php。三、不同币种精度不同一个容易踩的坑各币种的最小记账单位小数位并不相同EUR 是 2 位分、JPY 是 0 位、COP 是 0 位、BTC 是 8 位satoshi。Whisper Money 的所有金额统一以整数最小单位存储小数位由配置显式声明未知币种回退为 2 位。为什么这么讲究如果把汇率直接乘在存储的整数上两种精度不同的币种之间会差出一个 10 的幂次。正确做法是先还原成主单位 → 应用汇率 → 再缩放回目标币种的最小单位。这段注释值得读一读config/currencies.php。四、支持哪些币种如何新增一个币种币种总表config/currencies.php覆盖主流法币USD、EUR、GBP、JPY、CNY、CHF、CAD 等以及加密资产新增币种是一次配置变更不是一个功能加一个配置项 一行翻译即可校验、下拉框选项、汇率转换全部自动生效。官方开发者指南见 docs/adding-a-currency.md两个注意点指南里特别强调必须使用现行 ISO 4217 代码。加纳的例子旧代码GHC仍存在但汇率被重定价放大 10000 倍正确代码是GHS否则所有余额会膨胀 10000 倍确认汇率数据源确实覆盖该代码且汇率合理否则该币种仍可选择只是不会发生换算。五、文件导入与多币种导入时按账户原币记账通过全量导入功能搬入历史数据时币种机制同样生效映射账户先确认文件中每一列属于哪个账户每个账户保持自己的币种预览交易预览页显示的金额是账户的原币金额并标出 New / Duplicate 状态导入完成后仪表盘、现金流等视图自动按各交易日汇率折算为主显示币种无需任何手动操作。六、多币种管理最佳实践清单✅ 主显示币种选你日常开支用的那个CNY / USD / EUR✅ 每个账户的币种就设成银行流水实际记账的币种不要为了“好看”去人为统一✅ 查看历史余额时别期望“按今天的汇率”Whisper Money 按交易日取价这恰恰更准确✅ BTC 等加密资产可以当账户币种但不能当主显示币种✅ 需要的币种不在列表里先读 docs/adding-a-currency.md这是一个 5 分钟就能完成的配置变更。七、相关文件速查币种配置与精度定义config/currencies.php汇率拉取与缓存app/Services/CurrencyConversionService.php换算服务含精度缩放app/Services/ExchangeRateService.php、app/Support/Money.php币种选项与下拉框数据源app/Services/CurrencyOptions.php新增币种官方指南docs/adding-a-currency.md赞分享【免费下载链接】whisper-moneyUnderstand your personal finances. Forget Excels, try Whisper Money.项目地址https://gitcode.com/gh_mirrors/wh/whisper-money点击查看免费下载相关推荐OpenCart 货币管理实战指南汇率、显示格式与多币种商店配置OpenCart 货币管理实战指南汇率、显示格式与多币种商店配置 导读 本文以 OpenCart 管理后台的 System → Localization →电商后端终极Money Ruby库汇率转换完全指南轻松构建多币种金融应用终极Money Ruby库汇率转换完全指南轻松构建多币种金融应用 Money Ruby库是一款功能强大的Ruby货币处理工具专为处理货币计算和汇率转换而设计uni-app货币格式化终极指南多币种显示与精确计算uni app货币格式化终极指南多币种显示与精确计算 在全球化应用开发中 uni app货币格式化 是每个开发者都必须掌握的核心技能。作为使用Vue.js的示例工程前端移动开发跨平台创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
