地址测试数据的方法、来源与覆盖说明

为什么建立这套数据

不同国家对州、省、地区、邮编、电话号码和地址顺序的要求不同。一个只适配美国 City / State / ZIP Code 的表单，切换到香港、日本、德国或巴西后很容易出现必填项错误、字符丢失、邮编格式误判和字段顺序不自然。

本站把这些差异整理成结构化字段和合成样例，目标是让开发者和测试人员快速发现表单问题。生成结果不用于证明身份、确认住址或判断邮件是否可投递。

一条记录怎样生成

1. 先选择国家，再从该国家已配置的州、省、都道府县或地区中选择一项。
2. 城市、邮编和电话前缀按同一地区记录关联，避免完全随机拼接。
3. 姓名、街道、楼栋、单位和演示公司从对应语言或地区的测试词表组合。
4. 输出拆分字段、本地顺序完整地址、E.164 电话、语言与区域标记，供表单和 API 测试。
5. 传入相同 seed 可复现同一批结果，便于定位自动化测试失败。

所有姓名、邮箱、公司和街道样例均为合成数据。邮箱固定使用 example.com 保留域，记录同时标记 isSynthetic: true 和 addressStatus: synthetic-unverified。

自动测试与人工复核

每次上线前，测试会遍历 50 个国家、每个已配置地区和电话规则，并验证地区代码、城市与邮编对应、国家区号、字段完整性、本地语言资料和地址顺序。当前回归测试一次校验 31,600 组电话样例，同时检查全部国家的结构化地址字段。

内容维护时会将高频国家页与生成器实际配置对照，并记录最近复核日期。发现格式问题可在联系页提交页面网址、国家、预期格式和实际结果。

参考资料

实现和复核会参考下列官方或国际组织资料，并结合常见软件表单需要整理成测试字段：

• USPS Publication 28：美国邮政地址格式与缩写。
• ISO 3166 Country Codes：国家与地区代码。
• ITU National Numbering Plans：国家电话编号计划。
• UPU Addressing and Postcode Manual：国际地址与邮编体系背景。

这些来源用于理解规则，不表示 USPS、ISO、ITU 或 UPU 认可本站。具体投递、税务、开户或平台验证仍应以对应机构的实时要求为准。

50 个国家与地区的当前覆盖

下表由生成器的实际配置在构建时生成，因此页面说明和线上规则保持一致。地区数是本站配置的测试入口数量，不代表该国家完整行政区划数量。