跳到主要内容
← 返回列表

ICELEAF / JOURNAL

导出 XLSX 时,如何让公式形状的输入保持为文本

2026-10-14 09:48:31 / iceleaf

问题背景

开发表单导出功能时,需要把用户填写的文字保存到 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、复制到其他表格或再次导入时,会进入另一套解析流程,仍需重新验证。此次改动不能外推为对所有表格导出风险的完整防护。

参考资料

Microsoft Learn:Open XML 单元格结构与 inlineStr 说明

QUICK NAVIGATION

你想去哪里?

Esc 关闭 · 点击结果前往 · 全站搜索 →