PHPOffice/PhpSpreadsheet ODS格式导出中的缩进格式丢失问题解析

问题背景

在使用PHPOffice/PhpSpreadsheet进行电子表格处理时，开发者发现当将包含缩进格式的单元格导出为ODS格式时，缩进样式会丢失。这个问题在3.5.0版本中被报告，表现为虽然XLSX格式能正确保留缩进设置，但ODS格式却无法保持相同的样式表现。

技术细节分析

缩进格式是通过setIndent()方法设置的单元格对齐属性，属于样式系统的一部分。在XLSX格式中，这个属性会被正确转换为对应的XML标记，但在ODS格式的写入过程中，相关的样式转换逻辑存在缺失。

ODS格式基于OpenDocument标准，使用XML来描述电子表格内容。缩进属性在ODS中对应fo:text-indent属性，需要被写入到style:paragraph-properties节点中。当前的ODS写入器(OdsWriter)没有将这个PHP端的样式属性映射到对应的ODS XML结构中。

解决方案实现

修复此问题需要在OdsWriter中添加对缩进属性的处理逻辑。具体需要：

1. 在样式生成部分增加对缩进属性的检测
2. 将缩进值转换为ODS兼容的格式（通常以"cm"或"in"为单位）
3. 在生成的XML中正确添加text-indent属性

一个典型的实现会在writeStyles()方法中添加类似这样的处理：

if ($alignment->getIndent() > 0) {
    $indent = $alignment->getIndent() * 0.5; // 转换为cm单位
    $style->addAttribute('fo:text-indent', $indent.'cm');
}

影响范围

这个问题仅影响ODS格式的导出功能，其他格式如XLSX不受影响。所有使用缩进格式并需要导出为ODS格式的用户都会遇到此问题。

最佳实践建议

对于需要使用ODS格式并依赖缩进样式的开发者，建议：

1. 升级到包含此修复的PhpSpreadsheet版本
2. 如果暂时无法升级，可以考虑在导出ODS后使用其他工具进行后期处理
3. 对于关键业务场景，建议在部署前进行充分的格式验证测试

总结

样式属性的完整支持是电子表格处理库的重要功能。这个特定的ODS缩进格式问题展示了在不同文件格式间保持样式一致性的挑战。通过理解底层格式差异和实现适当的转换逻辑，可以确保用户在各种输出格式中获得一致的视觉表现。

对于PhpSpreadsheet用户来说，关注这类样式兼容性问题有助于避免在实际应用中遇到意外的格式丢失情况，特别是在需要支持多种输出格式的业务场景中。