Expensify/App项目中波兰城市名称编码问题的分析与解决

问题背景

在Expensify/App项目的Workspace Settings模块中，用户报告了一个关于波兰城市名称显示异常的问题。具体表现为：当用户导入波兰城市的每日津贴(per diem)费率数据时，城市名称"Wrocław"和"Kraków"显示为乱码"Wrocław"和"Kraków"。

技术分析

问题根源

经过技术分析，发现问题的根本原因在于XLSX库在读取文本文件时使用了错误的编码方式。具体来说，当处理包含特殊字符(如波兰语中的"ł"和"ó")的CSV或TXT文件时，系统未能正确识别和转换这些Unicode字符。

解决方案设计

开发团队提出了一个基于文件扩展名的差异化处理方案：

1. 对于CSV和TXT文件，采用文本模式读取，明确指定字符串类型
2. 对于其他格式文件(如XLSX)，继续使用二进制模式读取

这种区分处理的方式能够确保不同格式的文件都能以最适合的方式被解析，从而避免编码问题。

实现细节

解决方案的核心代码逻辑如下：

const {fileExtension} = splitExtensionFromFileName(file?.name ?? '');
const shouldReadAsText = fileExtension === 'csv' || fileExtension === 'txt';

const readWorkbook = () => {
    if (shouldReadAsText) {
        return fetch(fileURI)
            .then((data) => {
                setIsReadingFIle(true);
                return data.text();
            })
            .then((text) => XLSX.read(text, {type: 'string'}));
    }
    return fetch(fileURI)
        .then((data) => {
            setIsReadingFIle(true);
            return data.arrayBuffer();
        })
        .then((arrayBuffer) => XLSX.read(new Uint8Array(arrayBuffer), {type: 'buffer'}));
};

测试验证

为确保问题得到彻底解决并防止回归，团队设计了详细的测试方案：

1. 创建或使用现有Workspace
2. 启用每日津贴费率功能
3. 导入包含波兰城市名称的测试文件
4. 验证特殊字符的正确显示
5. 检查表格内容的整体准确性

测试文件包含德国和波兰的每日津贴数据，特别关注包含特殊字符的城市名称。

技术启示

这个案例为我们提供了几个重要的技术启示：

1. 文件编码处理在全球化应用中至关重要，特别是当处理多语言内容时
2. 不同文件格式可能需要不同的处理方式，不能假设统一的处理流程
3. 特殊字符的测试应该成为国际化应用的标准测试用例
4. 文件扩展名可以作为处理逻辑的重要判断依据

总结

通过这次问题的解决，Expensify/App项目增强了对多语言文件处理的能力，特别是对包含特殊字符的东欧语言的支持。这种解决方案不仅修复了当前的问题，还为未来处理类似的语言编码问题提供了可扩展的框架。

对于开发者而言，这个案例提醒我们在处理用户上传文件时，需要考虑文件格式、编码方式和目标语言特性等多方面因素，才能提供真正全球化可用的产品体验。