CSV 结构错误诊断与修复

CSV 结构修复针对字段数不一致、引用边界错误和分隔规则不匹配。清洗空格、去重或查找替换，通常要求单元格边界已经确定；如果引号没有闭合，直接清洗可能把后续多条记录误当成一个单元格。应先查看原文，再决定明确的修复方式。

工具保留原始字节和原解码文本，修复生成候选副本。结构验证通过仅表示候选符合所选 CSV 规则，不证明缺失的业务内容已恢复。对存在歧义的文件，最好同时保留来源系统的记录或重新取得导出文件。

选择原文件后，设置来源编码并点击“从原字节预览”。编码失败与引用错误分别处理。确认分隔符、引用字符、首条记录是否为表头；预期字段数为 0 时使用首条记录作为建议，也可以输入已知正确列数。

错误的分隔符可能让整行变成一列，却仍然在技术上保持“字段数一致”。因此不能只看是否报错，还要核对业务上应有几列、哪些字符是分隔符。字节片段采用字节位置，文本修改采用 UTF-16 码元位置，两者不能混用。

带引号的备注可以包含换行，一条逻辑记录因此可能占用多条物理行。问题列表会同时显示逻辑记录位置和物理行范围。边界明确时，短记录和多字段记录可以定位到具体记录，不用简单数换行代替 CSV 解析。

引号未闭合时，后续文本可能被解析成一个长字段。工具会标注边界不确定，并保留疑似影响范围；不会删掉后续文字后宣布成功，也不会编造准确的后续记录数。请查看上下文，只有知道正确边界时才添加文字修改。

对边界确定且字段少于预期的记录，可选择“补尾空字段”。预期三列、实际只有 1 和 2 时，结果为 1、2、空字段，前两值不变，日志保留修改前后及位置。这项操作不能判断缺失值是否其实位于中间；业务含义仍须用户核对。

字段过多时，可明确隔离整条记录供审阅，工具不会自动丢列或拼接字段。隔离内容进入报告。需要下载剩余正常部分时，必须明确选择部分结果，文件名也会带 PARTIAL 标识，不能把排除后的统计当作原文件完整结论。

“明确修改指定文本片段”提供起点、终点、替换文本和理由。位置按原解码文本的 UTF-16 码元从 0 计数，末位置不包含；不是字节数或可见字符数。提交前核对显示的原片段。不重叠修改可以组合，片段与原文不一致会阻断。撤销和重做只改变本地规则，不覆盖原文件。

例如表头是 id、name、note，第二条记录只有编号和名称，第三条记录却有四个字段。确认三列规则后，先预览问题；只有确定缺的是末尾备注，才对短记录补空。四字段记录应保留原文并隔离调查，而不是擅自删掉第四项。

明确选择部分结果并执行全量处理后，候选保留正常记录和补空后的短记录；隔离的整条原文保存在报告中。候选会按完整引用规则再次解析，验证引号内逗号、多行备注、双引号转义及末尾空字段。仅有 ZIP 文件或预览看起来正常，不算完整验证。

结构修复会重新序列化：采用所选分隔符和引用字符、CRLF 记录换行，并对空字段加引号。这些格式变化写入报告，与只转码不同。下载包包含候选 CSV、修改日志、排除片段和验证口径；报告可能包含敏感原值，应与原文件一起妥善保管。

空或重复表头可能不妨碍 CSV 结构解析，却会阻止后续按字段处理，需要另行整理表头。没有可靠引号边界时，可取得新的源系统导出，或在业务确认后输入具体修正，不承诺自动恢复丢失内容。

修改输入或规则后，旧结果过期；任务可取消。完整运行与分页展示分开，规模限制覆盖文件、字段、记录及运行时间。可继续把候选数据交给常规清洗；部分结果须始终保留范围说明。语言切换不改解析规则，刷新或关闭清空本地内存会话。

“CSV 公式起始内容添加单引号防护”控制下载副本的额外处理，本地修复候选保持原值。下载前与报告会列出受影响字段数，合法负数也可能被加单引号。必须保留字段原文时，可关闭防护并明确确认公式解释风险；防护不保证每一种表格软件都安全。