Maybe 财务项目中的 CSV 数字格式解析问题分析与解决方案

在 Maybe 财务项目中，处理 CSV 文件导入交易数据时遇到了一个关于数字格式解析的重要技术问题。这个问题主要影响非美元货币的交易记录导入，特别是当金额格式与项目当前假设的美元格式不同时。

问题背景

当前系统在处理 CSV 导入时，使用了一个简单的字符串清理函数来处理金额字段。这个函数会移除所有非数字字符，这在处理美元格式（如 1,234.56）时工作良好，但当处理其他货币格式时就会出现问题。

例如，欧洲常见的金额格式（如 1.254,54 欧元）会被错误解析。系统会移除所有非数字字符，将 1.254,54 转换为 125454，完全改变了原始金额值。

技术分析

问题的核心在于系统对数字格式的假设过于单一。不同地区使用不同的数字表示方法：

1. 美国/英国/亚洲格式：1,234.56（逗号作为千位分隔符，点作为小数点）
2. 欧洲大部分地区格式：1.234,56（点作为千位分隔符，逗号作为小数点）
3. 法国/北欧格式：1 234,56（空格作为千位分隔符，逗号作为小数点）
4. 日元等无小数货币：1,234（只有千位分隔符）

当前系统只考虑了第一种情况，导致其他格式的数据导入错误。

解决方案设计

为了解决这个问题，我们需要在 CSV 导入流程中增加两个配置选项：

1. 货币选择：让用户指定 CSV 文件中交易记录使用的货币类型
2. 数字格式选择：提供常见的数字格式选项供用户选择

基于用户的选择，系统应该：

1. 根据所选货币自动设置默认的数字格式
2. 使用正确的分隔符和小数点规则来解析金额字段
3. 在清理金额字符串时保留正确的数字结构

实现细节

在技术实现上，我们需要：

1. 扩展导入配置界面，增加货币和数字格式选择控件
2. 创建一个数字格式解析器，能够根据用户选择正确处理各种格式
3. 修改现有的金额清理逻辑，使其能够智能处理不同格式
4. 添加适当的错误处理和用户反馈机制

用户体验考虑

良好的用户体验应该：

1. 为常见货币提供合理的默认格式
2. 在用户选择货币时自动建议最可能的数字格式
3. 提供格式示例帮助用户理解不同选项的含义
4. 在导入预览阶段显示解析后的金额，让用户确认是否正确

总结

这个问题的解决将显著提升 Maybe 财务项目在国际化方面的能力，使全球用户都能方便地导入本地银行生成的交易数据。通过增加适当的配置选项和智能的解析逻辑，我们可以确保各种数字格式都能被正确理解，而不会影响现有的美元数据处理流程。

这种解决方案不仅解决了当前的技术债务，也为项目未来的国际化扩展奠定了良好的基础。