UD5工具箱
什么是XML扁平化？它和XML转CSV有什么关系？
XML扁平化是将XML的树形层次结构转换为二维表格结构的过程，这正是XML转CSV的核心原理。XML本质上是一种层次化数据格式，而CSV是扁平的表格格式。扁平化需要确定一个「行节点」（即每条数据记录对应的XML节点），然后将该节点下的所有子节点和属性展开为表格的各个列。例如，一个包含多个商品信息的XML，选择每个 <product> 节点作为行节点后，其子节点 name、price、quantity 会分别成为CSV中的列名。扁平化的质量取决于行节点的选择是否恰当，这也是使用本工具时最重要的操作步骤。
如何正确选择行节点？选错了会有什么后果？
行节点的选择直接决定了CSV表格的结构和数据完整性。正确的行节点应该是XML中「代表单条完整数据记录」的重复出现节点。工具会自动分析XML结构并列出所有候选节点供你选择。选错行节点的常见后果包括：数据粒度过粗（列太多、每行数据不清晰）或过细（数据被拆分过多、信息不完整）、部分字段丢失（选择的层级太高，某些数据被忽略）。建议在选择行节点后仔细检查预览数据，确认每行包含一条完整的业务记录。如果自动推荐的节点都不理想，可以在高级设置中使用XPath手动指定。
工具是如何处理XML属性的？为什么列名前面有@符号？
本工具完整支持XML属性（Attribute）的提取。在XML中，节点除了包含子节点和文本内容外，还可以在起始标签中携带属性，例如 <order id="1001" date="2024-01-15">。工具会自动检测这些属性并将其转换为CSV的列。为了在CSV中明确区分「来自属性的列」和「来自子节点的列」，我们在属性名前添加了@符号作为前缀，这是XML和数据领域的通用约定。因此上述节点的id和date属性会被映射为 @id 和 @date 两列。你可以在高级设置中自定义这个前缀字符，或者选择完全忽略属性数据。
CSV文件中包含逗号或双引号的字段是如何处理的？会不会导致列错位？
不会。本工具严格遵循RFC 4180标准来处理CSV中的特殊字符。当某个字段的内容中包含逗号、双引号或换行符时，工具会自动将该字段用双引号包裹起来；如果字段内容中本身包含双引号，则会将每个双引号转义为两个连续的双引号（即""）。例如，字段内容为「He said "hello"」会被输出为"He said ""hello"""。这种标准化的转义处理确保了输出的CSV文件能被所有符合RFC 4180标准的解析器（包括Excel、Google Sheets、Python的csv模块等）正确读取，不会出现列错位问题。
面对深层嵌套的XML（超过5层以上），工具能正常处理吗？
可以。本工具采用递归解析算法，理论上支持任意深度的XML嵌套结构。对于深层嵌套数据，工具会将从根节点到每个叶子节点的完整路径用斜杠拼接作为CSV列名，例如 orders/order/items/item/product/name。这种路径拼接策略确保了即使在复杂结构中，每个字段都有唯一且含义明确的列名。实际使用中，超过6-7层的嵌套可能导致列名过长，你可以通过选择更低层级的行节点来简化输出结构。工具在预览阶段会实时展示不同行节点选择的效果，帮助你找到最佳的嵌套处理方案。
为什么我的XML文件导入后中文显示为乱码？如何解决？
中文乱码通常是由于源XML文件的编码格式与工具的默认解析编码不一致导致的。本工具内置了智能编码检测引擎，能自动识别UTF-8、GBK、GB2312、GB18030等数十种常见编码，绝大多数情况下能正确处理。如果仍然出现乱码，可以尝试以下解决方案：首先在高级设置中手动指定源文件编码，如果你不确定文件编码，可以用文本编辑器（如Notepad++）打开XML文件，在「编码」菜单中查看当前编码格式；其次检查XML文件开头是否包含XML声明（如 <?xml version="1.0" encoding="GBK"?>），如果有，其中的encoding属性值即为正确编码。
转换后的CSV用Excel打开时中文还是乱码，怎么办？
这是一个非常常见的问题。原因是Microsoft Excel在打开CSV文件时，默认使用系统区域设置对应的编码（中文Windows通常是GBK），而不会自动检测UTF-8编码。如果CSV文件没有BOM（字节顺序标记），Excel会将其按GBK解码，导致UTF-8编码的中文字符显示为乱码。本工具在导出CSV时会自动在文件开头添加UTF-8 BOM（三字节标记 0xEF 0xBB 0xBF），这是让Excel正确识别UTF-8编码的关键。如果你使用其他工具导出的CSV遇到此问题，可以尝试在Excel中使用「数据」→「从文本/CSV」导入功能，并在导入向导中手动选择UTF-8编码。
我的XML文件有几十MB甚至上百MB，能处理吗？
由于本工具采用纯前端技术架构，所有处理过程在浏览器内存中完成，因此文件大小受限于浏览器的可用内存。在现代浏览器中，通常可以流畅处理几十MB的XML文件。对于超过100MB的超大文件，可能会遇到内存不足的问题。建议处理大文件时关闭其他标签页以释放内存。如果文件确实过大，可以考虑将XML拆分为多个较小的文件分别处理，或者使用服务端工具进行转换。工具会在文件过大时给出友好的提示信息。
工具会上传我的XML文件到服务器吗？数据安全如何保障？
绝对不会。本工具采用100%纯前端技术架构，所有XML解析、数据转换和CSV生成过程完全在你本地浏览器的内存中完成。文件内容不会通过网络传输到任何外部服务器。这是我们的核心设计理念之一——「数据不离机」。你的文件内容不会被存储、缓存或记录。浏览器标签页关闭后，所有处理数据会立即从内存中释放。我们无法也无法访问你处理的任何数据内容。这种架构从根本上保障了企业敏感数据、个人隐私数据的安全性，特别适合处理包含商业机密或个人身份信息的XML文件。
CSV输出中能否自定义分隔符？比如用制表符代替逗号？
可以。虽然CSV的「C」代表逗号（Comma），但在实际应用中，使用制表符（Tab）作为分隔符也非常常见，这种格式通常称为TSV（Tab-Separated Values）。当字段内容中经常包含逗号时，使用制表符分隔可以避免大量转义操作。本工具在高级设置中提供了分隔符选项，支持逗号（默认）和制表符两种选择。选择制表符分隔后，导出的文件扩展名建议改为 .tsv。无论使用哪种分隔符，工具都会严格遵循RFC 4180规范处理特殊字符转义，确保输出格式的标准性和兼容性。
如果XML节点的子节点结构不一致（有的记录多几列，有的少几列），工具如何处理？
这种情况在实际数据中非常普遍，我们称之为「稀疏XML」或「不规则XML」。本工具对此有完善的处理机制：工具会扫描所有行节点，收集全部出现过的子节点和属性，将它们合并为CSV的完整列集。对于某些行中不存在的字段，工具会自动以空值填充，确保所有行的列数完全一致。例如，如果第一条记录有name、price、discount三个字段，而第二条记录只有name和price，那么第二条记录的discount列会显示为空。这种处理方式保证了输出CSV的结构一致性，方便后续的数据分析和导入操作。