3+3 郵遞區號的門牌範圍怎麼解析:8 萬筆資料其實是一套文法

高雄市苓雅區林泉街 30 號,3+3 郵遞區號是 802042;同一個門牌的 3 樓,卻是 802579。這不是我的工具算錯,中華郵政的資料本來就這樣寫:林泉街「雙 28號至 34號」的 1 樓是一個碼,2 樓以上是另一個碼。
台灣郵遞區號查詢 ↗要能回答這種問題,就得讀懂官方資料裡每一筆「門牌範圍」。這篇記錄我怎麼做:
- 資料只用中華郵政「3+3郵遞區號應用系統」裡的資料庫檔,共 80,134 筆。
- 範圍字串看起來有兩百多種寫法,其實是一套文法:巷弄、單雙號、門牌、樓層四段,解析順序不能換。
- 一個門牌同時落在好幾筆範圍裡時,範圍窄的那筆優先;真的分不出來就只給 3 碼,不猜。
- 正確與否,靠 170 個地址跟中華郵政官方查詢對答案。
中間有幾段程式碼,看不懂可以直接跳過,不影響後面的內容。
資料從哪來:Windows 安裝程式裡的 rall1.dbf
中華郵政的下載專區 ↗有一個「3+3郵遞區號應用系統」,下載下來是三個 RAR 壓縮檔,解開後是一支 Windows 安裝程式。真正的資料不在網頁上,而是在裝好之後的 C:\Zip33U\DBF\rall1.dbf:一個 Big5 編碼的 dBASE 資料庫檔。
我平常用 Mac,所以是用 Wine 跑這支安裝程式,一路點完安裝,再用一支自己寫的腳本讀 rall1.dbf,轉成 UTF-8 的純文字檔。目前站上用的是 V2602 版(安裝程式日期 2026 年 4 月 27 日),轉出來每一列五個欄位:
802042 高雄市 苓雅區 林泉街 雙 28號至 34號 1樓
802579 高雄市 苓雅區 林泉街 雙 28號至 34號 2樓以上依序是 3+3 郵遞區號、縣市、鄉鎮市區、路名,最後一欄是門牌範圍。轉檔時順手做了兩件事:「台北市」這類寫法統一成官方的「臺北市」,南海諸島、釣魚臺這幾筆邊境離島的附錄列不收。
網路上也有別人整理好的郵遞區號資料,但多半已經過時,或是停在舊的 3+2 碼,所以站上規定只用中華郵政的官方檔案。多花一點功夫裝 Windows 程式,換到的是每一筆都追得到來源。
門牌範圍長什麼樣
下面是苓雅區頁面上,林泉街的其中幾筆(站上每個鄉鎮市區都有一頁這樣的對照表):

圖:同一條林泉街,用單雙號、區間、巷弄與樓層切成好幾段,各自對到一個 3+3 碼。
80,134 筆範圍字串裡,不重複的有 21,960 種。把數字都換成 N 之後,還剩 226 種寫法,最常見的是這幾種:
| 寫法 | 筆數 | 意思 |
|---|---|---|
| 全 | 36,651 | 整條路(或整條巷)都是這個碼 |
| 雙N號至N號 | 5,558 | 雙號,從某號到某號 |
| 單N號至N號 | 5,379 | 單號,從某號到某號 |
| N號 | 4,221 | 只有這一個門牌 |
| 雙N號以下 | 3,486 | 雙號,某號以下 |
| 單N號以下 | 3,467 | 單號,某號以下 |
| 連N號以下 | 1,500 | 單雙號都算,某號以下 |
| N巷全 | 1,471 | 整條巷 |
數字是我把資料檔逐筆分類算出來的(2026-11-15)。
一開始我把這些當成一條一條的特例寫判斷,寫到後來規則互相打架,改一個壞一個。2026 年 9 月整個重寫時才看清楚:它們是同一套結構拼出來的。
兩百多種寫法,其實是一套文法
每一筆門牌範圍都可以拆成四段,前三段可有可無:
[N巷] [N弄] [單|雙|連] 門牌子句 [樓層子句]- 巷、弄:「38巷 9弄單 13號以下」的範圍是在 38 巷 9 弄裡面,不是林泉街本身。
- 單、雙、連:只算單號、只算雙號,或是單雙都算(連號)。
- 門牌子句:「全」、某一號、「某號以上」「某號以下」「某號至某號」,以及跟附號(之 1、之 2 這種)有關的幾種寫法。
- 樓層子句:「1樓」「2樓以上」「3樓以下」「地下 3樓至 1樓」。
照這個結構解,80,134 筆全部解得出來。但結構對了還不夠,解析的順序才是重點:要先切樓層,再剝巷弄,再剝單雙,最後才解門牌子句。這三條順序,每一條都對應一個真的發生過的 bug。
三個寫反的地方
1. 看到「樓」就當成單一門牌。 舊版只要字串裡有「樓」,就整筆當成一個門牌處理,「雙 28號至 34號 1樓」被讀成「28 號」,林泉街 30、32、34 號因此查不到。改法是先從字串尾端把樓層子句切掉,剩下的「雙 28號至 34號」照一般範圍處理。全庫有 696 筆帶樓層,其中 449 筆是「範圍加樓層」,正是被這個 bug 弄壞的那一種。
2. 先判斷「全」,才剝單雙。 舊版先問「這筆是不是『全』」,再處理單雙號。結果「單全」剝掉「單」之後剩下的「全」,已經回不到那個判斷,單全 593 筆、雙全 647 筆整筆失效。改成先剝單雙,再判斷全。
3. 巷號被當成門牌上限。 臺北市大安區敦化南路一段有一筆「187巷單 77號以下」,意思是 187 巷裡的單號 77 號以下。舊版沒有先剝巷弄前綴,讓它掉進「以下」那條規則,把 187 當成主路的門牌上限,變成「敦化南路一段 187 號以下全包」。改成先剝巷、弄前綴;但臺北市中正區臨沂街「雙 6巷至 18號」這種巷號後面直接接「至」的,巷號是區間的端點,不能剝。
門牌子句本身也有順序:長的樣式要先比對,「含附號以下」要比「以下」先試,不然會被「以下」先吃掉。
這次重寫之後,我在 build 最前面加了一道關卡:80,134 筆每一筆都要解析成功,有一筆失敗就讓整個 build 失敗。中華郵政換新版資料時如果出現沒看過的寫法,我會在部署前就知道,而不是那一筆靜靜地從查詢裡消失。
把每一筆變成數線上的一段
解析完的範圍,最後都化成一條數線上的閉區間。座標是「主號 × 10000 + 副號」,所以 48 號 < 48之1 號 < 49 號:
// 「雙 28號至 34號 1樓」解析後(只列重點欄位)
{ parity: 2, lo: 280000, hi: 340000, floorMin: 1, floorMax: 1 }parity: 2 是只算雙號,lo、hi 是 28 號到 34 號,樓層限定 1 樓。
有兩個細節是對過資料才確定的:
- 沒寫「之」的端點,不包含它的附號。 基隆市仁愛區港西街「81號」是 200092,「連 81之 1號以上」是 200002,所以 81 號這一筆只管 81 號本身。
- 巷也在數線上佔一個位置。 林泉街有一筆「雙 48之 1號至 80巷」,起點是門牌、終點是巷口,兩端在同一條數線上比大小就好,不用特別處理。
一個門牌命中好幾筆時,誰說了算
同一個門牌常常同時落在好幾筆範圍裡,例如林泉街 30 號同時符合「雙 28號至 34號 1樓」與「雙 28號至 34號 2樓以上」,差在樓層。我在重寫時把全庫逐條路兩兩比對:會同時命中同一個門牌、碼又不一樣的組合有 6,454 組,其中 98.6% 是一段完整包住另一段。所以排序的第一條規則很單純:範圍窄的優先。
完整的排序是:
- 範圍窄的優先。
- 寬度一樣時,有分單雙號的優先(「單全」贏過「全」)。
- 再一樣時,樓層限制窄的優先。
- 還是一樣,取樓層低的那筆。
- 全部都一樣而且碼不同,代表資料本身有歧義:不猜,只給 3 碼。官方查詢對這種地址也只給 3 碼。
套上這套規則之後,用全庫 56,537 個測試門牌跑一遍,排完還平手而且碼不一樣的是 0 筆。
樓層的處理是另一個重點。使用者沒寫樓層時,我把它當成 1 樓,而且是硬性過濾、不是排序偏好。這是照官方查詢的行為定的:

圖:沒寫樓層,查到 1 樓那筆 802042,結果卡下面會寫出命中的是哪一筆範圍。

圖:寫了 3 樓,就換成「2樓以上」那筆 802579。
我也試過把樓層改成排序偏好(有樓層限制的排後面),結果跟官方對答案時(當時的 150 題)多錯了 16 題,所以維持硬過濾。
嚴格比對找不到時,會照固定順序放寬:忽略之幾號、放寬弄、找巷子裡的缺口、放寬我替使用者假設的 1 樓,最後在巷與主路之間互相退讓。每一步怎麼放寬,都是先看官方查詢怎麼回答才寫進去的。但樓層如果是使用者自己寫的,濾空了就是查不到,不會放寬。
地下樓層也有一條:「N樓以下」是 1 樓到 N 樓,不包含地下。南投市復興路 2 號有一筆「2號 3樓以下」是 540231,但官方查詢「南投市復興路2號B1」只給 3 碼 540,所以站上也一樣。
怎麼知道對不對:跟官方查詢對答案
中華郵政有自己的線上查詢服務。我把 170 個地址丟去官方查詢,答案存成題庫,之後每次跑測試都重放一遍:站上的答案要跟官方一模一樣。
這 170 題包含一般門牌、巷弄、之幾號、各種樓層寫法、地下樓層,以及官方路名寫「台」而不是「臺」的路。目前 164 題一致,另外 6 題是官方資料自己對不起來,例如新北市板橋區中正路 8 號,rall1.dbf 寫的是 220043,官方查詢卻給 220040。這 6 題列在一份白名單裡,測試規定白名單只能縮短不能變長:官方哪天修好了,那一題就要從白名單拿掉。
另外還有一道關:全台每一條分「段」的路,輸入「2段」「2段」跟「二段」都要查到一樣的路名與 3+3 碼,差異必須是 0 筆。這是因為原始資料只有中文的段別,曾經有地址因為段別寫成阿拉伯數字而查錯碼。
小結
- 資料只用官方檔案:麻煩一點也要從中華郵政的應用系統裡拿
rall1.dbf,每一筆都追得到來源。 - 先找出文法,再寫程式:兩百多種寫法拆成巷弄、單雙、門牌、樓層四段,順序寫錯就是 bug。
- 規則跟著官方行為走:樓層怎麼假設、什麼時候放寬、平手時給什麼,都是先看官方查詢怎麼回答。
- 答案要能自動對:170 題官方題庫加上全庫解析關卡,資料換版時第一時間就會知道。
想查自己家的碼,可以直接用台灣郵遞區號查詢 ↗,輸入完整地址就會顯示 3 碼與 3+3 碼,也會寫出命中的是哪一筆範圍。要寄國外的話,同一個地址可以接著用地址中翻英 ↗。
延伸閱讀:
- 地址中翻英的資料怎麼做,寫在郵遞區號站英文版怎麼蓋。
- 想知道舊的 5 碼跟現在的 6 碼差在哪,郵遞區號站有一篇寄件指南 ↗。
資料版本:中華郵政「3+3郵遞區號應用系統」V2602(2026-04-27 發布)。文中的筆數與例子,是 2026-11-15 對這一版資料與站上查詢逐項核對的結果。