ExcelJS导出法语内容的Excel文件无法打开的问题求解

出现英文导出正常、法语导出就报文件损坏的情况，绝大多数诱因都和法语场景下的特殊字符、本地化规则破坏xlsx文件内部结构有关，具体常见原因：

• 法语特有重音字符触发XML格式损坏。xlsx本质是带固定目录结构的ZIP压缩包，内部所有配置、单元格内容都以XML格式存储，XML对字符编码、特殊字符转义有严格校验。法语内容包含大量非ASCII的重音字符（é、è、ê、à、â、œ等），如果开发时存在手动拼接XML片段、没有统一走ExcelJS原生API写值的逻辑，这些字符会直接破坏XML的语法结构，导致Excel打开时判定文件损坏——而纯英文的ASCII字符不会触发这类校验问题。
• 法语本地化的数值/日期格式化错位。法语区默认使用fr-FR locale，数值以逗号作为小数点分隔符、点作为千位分隔符，日期格式默认是日/月/年，月份名都是法语缩写。如果导出逻辑直接把前端做过本地化格式化的字符串（比如"123,45"、"15 janv. 2024"）硬绑定为数值、日期类型的单元格值，会往XML中塞入不符合数值/日期规范的字面量，直接触发格式校验失败。
• 本地化元数据的编码不匹配。ExcelJS会把工作簿的创建者、标题、描述等元数据写入包内的核心XML文件，如果切换法语后这些元数据自动填充了带重音的法语内容，而导出链路中存在转码环节（比如把buffer转字符串再转回时用了非UTF-8编码），就会导致元数据块的XML编码声明和实际字符不匹配，整份文件被判损坏。

• 所有单元格写入统一走ExcelJS原生API，绝对不要手动拼接XML字符串。给单元格赋值时，数值类直接传纯数字值、日期类直接传Date对象，不要把前端本地格式化后的带特殊分隔符的字符串硬塞为对应类型；需要自定义展示格式的，通过单元格的numFmt属性配置，比如展示法语风格日期就设置numFmt: 'dd/mm/yyyy'，和实际传入的原始值类型匹配。
• 特殊字符统一做转义兜底。所有传入ExcelJS的文本内容，提前对XML敏感字符（<、>、&、"、'）做实体转义，同时确保整个导出链路强制使用UTF-8编码处理字符串，不要出现Latin1、GBK等不兼容法语重音字符的转码逻辑。
• 元数据和下载文件名做编码兼容。设置工作簿元数据时，如果需要塞本地化文本，确保经过UTF-8编码处理；下载带特殊字符的文件名时，用encodeURIComponent做编码后再写入下载流，避免因为文件名特殊字符导致的流截断、元数据写入错位。
• 增加导出前的格式校验。拿到ExcelJS生成的导出buffer后，先校验文件头是否符合ZIP包规范（xlsx的固定文件头为PK开头的二进制标识），如果校验不通过就提前排查哪一步的转码逻辑出了问题，不要等文件下载下来才发现损坏。

内容的提问来源于stack exchange，提问作者Kusal Kithmal