数据导出与管线 5 min 2026-11-22

彻底解决 Excel 打开 CSV 时吞掉 02108 前导零邮编的问题

双击打开 CSV 往往会悄悄毁掉新英格兰、新加坡、首尔和德国东部的测试邮编——看看 AddressQA 是如何默认防吞零的。

快速落地步骤清单
  1. 在文件头写入 UTF-8 BOM (\uFEFF): 避免 Windows 版 Excel 打开中日韩与德法重音街道名时出现乱码。
  2. 对前导零邮编使用 ="02108" 保护: 符合 /^0/ 的邮编按 RFC 4180 转义为 "=""02108""",强制 Excel 以纯文本显示。
  3. 脚本入库优先调用 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},从源头杜绝隐式数字转型。

延伸阅读

更多 QA 工程指南

CI 与自动化测试

在 Playwright 与 Cypress CI 中构建确定性地址测试夹具

深入拆解无种子随机数据引发 CI 间歇性失败的根因,并演示如何用 AddressQA 固定种子接入 Playwright 参数化测试矩阵。

支付与税率测试

用美国五大免税州邮编验证 Stripe AVS 与销售税逻辑

区分“绝对 0% 州”与“含地方税例外州”,一键导出标准 Stripe shipping 与 billing_details 测试对象。

电信合规与号码规范

监管安全测试电话指南:NANPA 555、Ofcom、ACMA 与 E.164 规范

为什么不能在测试库里随手填随机手机号?对照全球通信监管局官方保留号段表,让自动化测试既真实又零风险。