数据导出与管线 5 min 2026-11-22
彻底解决 Excel 打开 CSV 时吞掉 02108 前导零邮编的问题
双击打开 CSV 往往会悄悄毁掉新英格兰、新加坡、首尔和德国东部的测试邮编——看看 AddressQA 是如何默认防吞零的。
快速落地步骤清单
- 在文件头写入 UTF-8 BOM (\uFEFF): 避免 Windows 版 Excel 打开中日韩与德法重音街道名时出现乱码。
- 对前导零邮编使用 ="02108" 保护: 符合 /^0/ 的邮编按 RFC 4180 转义为 "=""02108""",强制 Excel 以纯文本显示。
- 脚本入库优先调用 JSON 接口: 若由 Python/Node 自动化直接读取,优先请求 /api/v1/fixtures?format=json 或显式声明列类型为字符串。
表格双击引发的隐蔽邮编损坏
许多运营和 QA 习惯用 Excel 直接双击打开导出的 CSV:波士顿 02108 立刻变成 2108,新罕布什尔 03101 变成 3101,罗马 00187 变成 187,保存覆盖后测试数据即永久失真。
AddressQA 的 RFC 4180 防吞零导出策略
切换到工作台右侧的“CSV(防吞零)”标签,系统会自动附加 UTF-8 BOM、采用 RFC 4180 标准 CRLF 换行,并对所有 0 开头的邮编写入公式级文本锁:
fixture_id,seed,full_name,phone_e164,city,state,postal_code,country
qa-nh-01-1-US-NH,qa-nh-01,Claire Mercer,+16035550142,Manchester,NH,"=""03101""",US 自动化脚本消费建议
如果是给 pandas 或 Playwright 脚本直接消费,建议拉取 JSON 或在 read_csv 中显式传入 dtype={"postal_code": str},从源头杜绝隐式数字转型。
立即在 AddressQA 控制台验证: 打开分屏测试夹具控制台 → · 查看美国免税州矩阵 →