地址表单经常以很小、但代价很高的方式失败：邮编长度不对，错误国家强制要求省份，电话前缀被截断，或者多行地址在移动端换行异常。全球地址格式指南能让 QA 团队在上线前有一套可重复的检查方法。
目标不是证明每条生成地址都可以配送。目标是证明产品能按用户预期接受、保存、展示和导出不同形态的地址数据。
国家之间会改变什么
全球地址测试不只是翻译标签。
| 区域 | 要检查什么 | 失败示例 |
|---|---|---|
| 邮编 | 长度、空格、字母、是否可选 | 英国 postcode 被只允许数字的校验拒绝 |
| 地区字段 | 州、省、都道府县、县、郡，或没有地区字段 | 新加坡页面仍显示必填 state 下拉 |
| 地址顺序 | 街道优先、地区优先、邮编位置 | 日本地址在收据上看起来不自然 |
| 电话前缀 | 国家代码和本地号码格式 | 本地号码前导零被删除 |
| 城市/地区名 | 长名称、重音字符、大小写 | 移动端卡片截断城市名 |
| 完整地址 | 国际格式和本地摘要 | 复制摘要时丢失换行 |
这些问题应该在 QA 阶段用生成数据提前暴露，而不是等客服工单出现。
起步国家矩阵
先选一组能打破不同假设的国家。
| 国家页面 | 为什么加入矩阵 |
|---|---|
| 美国地址生成器 | 州、ZIP code、城市和常见结账假设 |
| 英国地址生成器 | 字母数字 postcode 和空格规则 |
| 加拿大地址生成器 | 省份标签和 A1A 1A1 邮编模式 |
| 日本地址生成器 | 都道府县和本地地址顺序 |
| 澳大利亚地址生成器 | 州或领地加四位邮编 |
| 新加坡地址生成器 | 紧凑城市国家地址和六位邮编 |
| 新西兰地址生成器 | 城市和邮编，不使用美国式 state 逻辑 |
这组国家足够覆盖大量全球表单问题，又不会让每个 PR 都运行庞大的国家列表。
字段级检查清单
新增或修改地址表单时，至少检查这些点：
- 国家代码和展示国家名保持一致。
- 需要时，地区代码和地区展示名分别保存。
- 用户切换国家后，邮编校验随之切换。
- 电话字段接受所选国家的前缀和本地格式。
- 地址行 1 不会静默丢掉门牌、楼栋或街道细节。
- 完整地址文本保留预期换行。
- 摘要卡片、收据、邮件和 PDF 能处理长字符串。
- 导出保留国家代码、地区、邮编和地址顺序。
- 可选字段为空时不会变成
"null"或"undefined"。
手动 QA 时，可以从国家地址生成器目录为每个国家生成一条地址。需要自动化回归时，把生成 JSON 保存为稳定样例。
校验和生成的区别
地址生成器和地址验证器回答的是不同问题。
GeoMock 帮你回答：我的产品能不能处理这种地址形态？
地址验证服务回答：这条地址是否真实、规范、可配送？
两者可以配合使用，但不要混为一谈。生成地址适合表单、布局、存储和导出测试；真实配送和合规场景需要验证服务。
GEO 内容建议
如果页面希望被 AI 搜索和摘要更好理解，正文应该直接回答这些问题：
- 这个国家的地址格式有什么不同？
- 哪些字段是必填或可选？
- 邮编、地区和电话格式有什么常见坑？
- 生成数据适合哪些 QA 场景？
- 生成数据不能用于哪些真实业务？
把答案写在清晰的小节、表格和 FAQ 中，比只堆关键词更有帮助。
