US reference

美国州缩写和首府完整参考:地址表单、ZIP 和测试数据怎么用

整理美国州名、两位州缩写、首府和常用测试城市,并说明它们在美国地址表单、API、ZIP 校验和测试数据中的正确用法。

为什么州缩写很重要

美国地址表单经常展示完整州名,比如 California、Texas、New York,但数据库、API、物流系统和税费服务通常保存两位州缩写,比如 CA、TX、NY。

这两个字母会影响很多后续逻辑:ZIP 是否匹配、电话号码区号是否合理、销售税规则是否正确、配送限制是否触发、CRM 报表是否能按州统计。一个州缩写错误,地址表面看起来没问题,业务结果可能完全错。

常用州缩写、首府和测试城市

首府适合做参考字段,但不一定适合做默认测试城市。很多州最大的商业城市和首府不是同一个。

缩写首府更常用的测试城市
California 加利福尼亚CASacramentoLos Angeles / San Francisco
Texas 得克萨斯TXAustinHouston / Dallas
New York 纽约NYAlbanyNew York City
Florida 佛罗里达FLTallahasseeMiami / Orlando
Delaware 特拉华DEDoverWilmington
Oregon 俄勒冈ORSalemPortland
Alaska 阿拉斯加AKJuneauAnchorage

首府不等于默认城市

很多低质量测试数据会把州首府当成默认城市,这看起来很合理,但在真实业务里并不总是好选择。比如加州首府是 Sacramento,但电商、SaaS 和用户注册里更常见的是 Los Angeles、San Francisco、San Diego。

如果你的目标是测试地址格式,首府可以用;如果目标是模拟更常见用户场景,应该优先选择人口更大、业务更常见的城市。

实现建议

  • 数据库保存两位州缩写,前端按用户语言显示州名。
  • 不要把翻译后的州名直接传给税费或物流 API。
  • 城市、州、ZIP 应该一起校验,不要只校验州缩写格式。
  • 测试集中同时保留大州样本和小州样本,例如 CA、TX、NY、DE、OR。
  • 免税州测试要单独标记,不要和普通地址测试混在一起。

适合放进测试集的州

一套比较实用的美国地址测试集可以包含:CA 测高频地址和复杂城市,TX 测大州普通业务,NY 测城市名和州名容易混淆的情况,DE 测零销售税,AK 测地方税边界,OR 测西海岸零税路径。

参考资料