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 測西岸零稅路徑。

參考資料