问题背景
开发表单导出功能时,需要把用户填写的文字保存到 XLSX 文件。这里有一个容易忽略的问题:有些输入以等号开头,看起来像电子表格公式,但用户可能只是在描述一个表达式或举例。
例如,下面的内容只是一个说明用的测试值:
=1+1
如果把它保存成公式单元格,打开文件时就可能得到计算结果,原本的输入含义也随之改变。对于这类用于查看填写原文的导出,目标是保留文字,而不是执行其中的表达式。
从单元格类型入手
XLSX 工作表中的文本和公式有不同的表示方式。此次实现选择把导出值明确写成内联字符串,即将单元格类型设为 inlineStr,并把文字放入 is 和 t 元素中。
下面是对应结构的简化示例:
<c r="A1" t="inlineStr"> <is> <t xml:space="preserve">=1+1</t> </is> </c>
这里没有生成公式元素 f。即使字符串的外观看起来像公式,也按文本写入。与修改用户输入相比,显式指定单元格类型更符合此次导出需要。
处理 XML 字符与空白
单元格里的原文还可能包含与 XML 语法冲突的字符。写入 XML 前,需要正确转义,例如把小于号和与号转换为对应实体,避免生成无效的工作表文件。
此次 PHP 实现使用 htmlspecialchars,并指定 ENT_XML1、ENT_QUOTES 和 UTF-8。同时,在写入前过滤 XML 不允许出现的字符,避免异常控制字符破坏文档结构。
文本节点使用 xml:space="preserve" 表达保留空白的意图。需要区分:非法字符过滤是格式兼容处理,不能因此把导出称为任意输入的逐字节无损副本。
怎样核对导出结果
文件能够下载,并不代表单元格类型正确。此次已有验证记录使用独立的 Excel 读取库打开生成文件,确认导出的 26 列完整,公式形状的测试输入仍保持文本,没有作为公式保存。
检查这种导出时,可以把以下几项一起核对:
文件能否被独立读取库正常打开。
列数、表头和每行字段顺序是否符合导出定义。
以等号开头的内容是否仍是字符串,公式字段是否为空。
中文、换行和 XML 特殊字符是否按预期保留。
上面的清单用于说明检查方法;本次历史记录明确支持的结果是独立读取成功、26 列完整及公式形状输入保持文本,不据此声称已经覆盖所有电子表格软件和全部特殊字符组合。
适用范围与取舍
当前实现统一按文本导出,因此适合查看填写原文。相应地,即使某些字段看起来是数字,也不会自动成为可直接参与计算的数值单元格。
如果后续需要数值统计,应根据字段定义分别设置数值和文本类型,并继续把自由填写内容作为文本处理。这属于后续设计选择,不是本次已经完成的功能。
这种处理针对的是当前 XLSX 写出方式。另存为 CSV、复制到其他表格或再次导入时,会进入另一套解析流程,仍需重新验证。此次改动不能外推为对所有表格导出风险的完整防护。