EasyExcel 读取 Excel 时保留单元格前后空格的解决方案

问题背景

在使用 EasyExcel 进行 Excel 文件读取时，开发人员经常会遇到一个常见问题：默认情况下，EasyExcel 会自动去除单元格内容前后的空格。这在某些业务场景下可能不符合需求，特别是当单元格中的前后空格具有特殊含义时。

问题分析

EasyExcel 3.3.4 版本默认启用了自动修剪(autotrim)功能，这意味着在读取单元格内容时，系统会自动去除字符串前后的空白字符。虽然这在大多数情况下是合理的，但对于需要保留原始数据的场景，这种行为就不太合适了。

解决方案

通过分析 EasyExcel 的源码和功能，我们发现可以通过设置 autotrim 参数为 false 来禁用自动修剪功能。这样就能保留单元格内容的原始状态，包括前后的空格。

实现方式

在 EasyExcel 中，可以通过以下方式实现：

1. 构建读取监听器：创建一个继承自 AnalysisEventListener 的监听器类，用于处理读取到的数据。

2. 配置读取选项：在构建 ExcelReader 时，通过 ExcelReaderBuilder 设置 autotrim(false)。

ExcelReaderBuilder readerBuilder = EasyExcel.read(inputStream)
    .head(YourDataClass.class)
    .autoTrim(false)  // 关键设置
    .registerReadListener(yourListener);

注意事项

1. 性能考虑：禁用自动修剪可能会略微增加内存使用量，因为需要存储额外的空白字符。

2. 数据一致性：确保业务逻辑能够正确处理包含前后空格的数据，避免因保留空格而引发意外问题。

3. 版本兼容性：此功能在 EasyExcel 3.x 版本中可用，如果使用更早版本可能需要升级。

最佳实践

对于需要精确控制数据读取的场景，建议：

1. 明确业务需求，确定是否需要保留空格
2. 在测试环境中验证禁用自动修剪后的数据处理逻辑
3. 在文档中记录这一特殊配置，便于后续维护

通过合理配置 EasyExcel 的读取参数，开发者可以灵活地满足各种业务场景下的数据处理需求，包括保留单元格原始格式这种特殊场景。