AddressLab · 指南
地址表单怎么测？用同一条记录核对复制、保存和导出
首次发布: · Chrome · 2026-10-24
先固定一条记录，再比较每一步的数据。连续生成不同地址，无法判断数值变化来自随机生成还是保存错误。本次样本的邮编 03301 在保存、刷新恢复和已保存记录导出后保留了前导零；刷新后顶部当前面板恢复默认示例，原记录仍在“已保存”列表中。
面向检查英文地址表单、接口字段和导入导出的开发与测试人员。本次实测的是 AddressLab 本地保存与文件导出，没有测试真实电商订单、业务数据库、配送或税务引擎。截图来自中文工具。
先生成一条新罕布什尔州样本
打开美国免税州地址生成器，选择 New Hampshire（NH），再点“生成地址”。这里使用州筛选是为了得到前导零邮编样本，不是确定真实订单的税务结果。初始固定示例可以复制或导出，生成记录后“保存”才会启用。
本轮完整输出为 7401 State St, Concord, NH 03301, United States。下次生成通常会得到别的记录；要复现文件对照，请下载本次快照，或先记下自己生成的原值。
| 字段 | 生成、保存与导出值 |
|---|---|
street | 7401 State St |
city | Concord |
region | New Hampshire (NH) |
postalCode | 03301 |
country | 美国 |
保存、刷新后，从已保存列表导出
- 复制一次，核对完整地址和字段中的街道、城市、州及邮编。不要在对照途中再次生成。
- 点击保存，刷新页面，展开“已保存”。核对原记录仍然存在；不要把顶部默认示例误当成原记录。
- 选择“导出已保存记录”的 JSON 和 CSV。若刷新后导出的是当前面板，就会拿到另一条记录。
- 用文本方式检查文件字段和值。JSON 中 postalCode 应为字符串；CSV 中的原始字符与表格软件显示结果需要分开检查。
本次刷新后仍有 1 条已保存记录，JSON 邮编为字符串 03301，CSV 解析后的同一字段也保留该值。本次没有启动桌面 Excel，不能据此声称 Excel 会自动保留前导零。
下载实际 JSON · 下载实际 CSV。表格导入问题可继续看CSV 导入 Excel 的前导零排查。
中文字段名、显示值与接口键不要混用
| 源字段 | 常见目标 | 应核对的差别 |
|---|---|---|
street | Address Line 1 | 街道与门牌的组合，不应机械套用中国地址顺序。 |
region | State 下拉框 | 默认导出为 New Hampshire (NH)，需映射到目标选项 NH；导出没有独立 regionCode 字段。 |
postalCode | ZIP 文本框 | 不能因只有数字就转换成数值类型。 |
country | 国家代码 | 中文导出为国家显示名称；如接口要求 US，应明确映射，不能假定文件已有 countryCode。 |
HTML 的 address-line1、address-level2、postal-code 等 autocomplete 标记用于说明输入框用途，不会替你验证地址。对接自己的表单时，同时查看请求和响应；只比较页面上的中文标签，容易漏掉字段映射错误。
把固定记录用于结账回归，而非判断税额
原“免税州结账测试”指南已并入本节。先固定购物车、客户类型、配送方式和地址快照，再按自己已配置的税费或配送服务记录预期结果。每次只更换一组目的地字段，比较请求、服务响应、页面汇总和重新打开的草稿。
- 改州后同时核对城市与 ZIP，防止旧邮编仍留在请求里。
- 分别检查“账单地址同收货地址”的选中与取消状态，确认修改没有覆盖错误的地址对象。
- 预期税额由目标系统配置或税务服务给出；生成器的州筛选不计算税额，也不证明任意交易免税。
这些是要在你自己的预发布环境中执行的检查。本轮没有提交结账、付款或税费计算请求；真实收货应使用收件人确认的地址。
找到值第一次变化的位置
| 第一次不同的位置 | 优先排查 |
|---|---|
| 输入正确，请求变了 | 输入组件类型转换与 payload 映射。 |
| 请求正确，保存后变了 | 服务端规范化、数据库类型和导入结构。 |
| 已保存值正确，导出不同 | 导出了当前记录还是已保存记录，以及字段选择。 |
| CSV 原文正确，Excel 显示不同 | 按文本导入邮编列，先保留原文件。 |
提交问题时附原记录、版本、复现步骤和相关请求/响应，移除真实客户信息。多国字段差异看国际地址边界测试，美国输入接受规则看ZIP 实测用例。
测试范围与资料来源
本文由 AddressLab 使用 AI 辅助整理，依据实际浏览器操作记录与下列一手资料核对。测试于 2026 年 10 月 24 日在本地生产构建、独立 Chrome 环境中完成；功能测试期间拦截了外部广告与统计请求。这些观察不能证明地址分配、实际投递、邮箱所有权或税费结果。