表格软件显示正常而导入错列，常与编码、引号及自动类型推断有关，需要明确文件契约。
CSV 不保存强类型，编号前导零、长数字和日期可能被转换。引号内的逗号不是列分隔，不能用简单 split 解析。
一、问题的范围与前提
数据类型、单位、身份、时间与质量构成一份完整观测。传输格式相同不说明物理含义相同，接收成功也不说明数据新鲜。聚合与展示是派生层，应能回到输入范围与转换规则。
二、技术分析与方案取舍
编号应按字符串读取，例如前导零一旦被表格工具转换成整数，后续程序无法凭空恢复。带逗号、双引号和换行的文本由标准 CSV 规则解析，空字段再按字段字典解释。导入报告保留行号与拒绝原因，部分成功是否允许由业务定义。先用小样本检查编码和表头，再处理全量，避免一开始覆盖原数据。
建立测点和字段字典，明确空值、错误码、复位和晚到数据的处理。数值计算由确定性程序完成，保留版本和必要输入；文本解释只描述实际计算结果。按统计对象和时间窗口组织数据，避免不同分母或单位被放到同一比较中。
三、实现与排查的顺序
- 确认编码换行。
- 使用标准解析器。
- 按字典转换类型。
- 保留错误行原因。
按这个顺序保留中间结果，可以区分输入条件、处理过程和最终输出。前一阶段的条件不成立时，先解释对应错误，再继续后面的试验；单次返回成功不足以覆盖整条链路。
最小示例
1
2
3
4
5
import csv
with open("example.csv", newline="", encoding="utf-8-sig") as stream:
for row in csv.DictReader(stream):
print(row)
标准解析器处理引号和分隔符，utf-8-sig 可处理相应 BOM。字段值仍为文本，类型和单位需要字典转换，不能从一次打印结果推断整个文件正确。示例不包含真实业务数据。
示例聚焦当前技术关系。引用的图片、数据库、消息对象或处理函数，需要由调用环境提供；它不包含完整服务的认证、持久化与并发管理。验证时先用受控输入检查，再纳入应用。
四、验证和结果解释
样本核验覆盖边界、缺测、重复和异常范围，保存被排除数据的理由。图表与正文引用相同版本，公式改变后对应结果也更新。高频采样不自动拥有更大业务权重，统计方法应符合物理量与任务目标。
| 需要验证的结果 | 保留的对照 | 不能由此推出的结论 |
|---|---|---|
| 引号换行正确 | 固定输入与配置、对应输出 | 一次成功代表所有条件成功 |
| 编号不丢零 | 中断前后状态与错误阶段 | 没有报错代表结果正确 |
| 空值与零值不同 | 恢复后的同条件复测 | 临时恢复代表根因已经消失 |
验证导入失败、晚到补传、重复记录和配置修订。系统不应把无效数据默默转换成正常零值，也不为了曲线好看隐藏缺失。涉及真实人员或业务敏感资料时，示例只保留脱敏结构，不公开原始附件。
五、适用边界与结论
少量样本不能永久代表全量类型，个人数据不进入公开示例。
这条路径把“确认编码换行”与“保留错误行原因”连在一起，中间保留可复查的条件。实施时优先确认“引号换行正确”，再检查“空值与零值不同”；两者都满足，才能在当前样本与配置范围内评价方案。设备、数据或软件版本改变以后，相关假设需要重新验证。
