錢包描述符是什麼？Wallet Descriptor、xpub 與還原教學

作者｜桑幣區識編輯團隊
發布｜2026/10/29
更新｜2026/10/29

把同一份助記詞還原到另一款比特幣錢包，為什麼有時看不到原本的餘額？除了助記詞與額外密語是否正確，還要確認軟體使用了相同的帳戶、推導路徑與地址規則。

錢包描述符（Wallet Descriptor）就是用來表達這類設定的工具。它把金鑰與腳本規則整理成可交換的文字，讓相容軟體更清楚知道應該尋找哪些輸出與地址。

不過，描述符不一定只含公開資訊，也不能一概取代助記詞。本文將介紹它的用途、與 xpub 及 PSBT 的差別，並整理匯入公開描述符時的核對流程。

Table of Contents

錢包描述符是什麼？

比特幣中的 Output Script Descriptor，通常稱為輸出腳本描述符，也常被稱作錢包描述符。它是一套用來描述輸出腳本集合的文字語法；BIP380 定義其通用運作、金鑰表達方式及校驗碼等規則。

對一般使用者而言，可以把它理解為「金鑰應該如何用來建立地址與辨認資產」的設定說明。

同一把公鑰可以搭配不同腳本規則，建立不同的輸出。只提供金鑰，而沒有告訴軟體應使用哪一種規則，就可能出現還原後地址不同、交易紀錄不完整等情況。

描述符可以說明哪些內容？

依描述符種類與匯出內容，可能包括：

使用哪一種腳本或地址規則。
使用哪些公開金鑰、延伸金鑰或其他金鑰資料。
金鑰來源指紋、推導路徑與後續推導方式。
多簽門檻與共同簽署者的金鑰設定。
固定輸出，或帶有範圍的地址集合。

不是每份描述符都包含以上全部內容，也不是一份描述符就能代表所有帳戶、地址類型與錢包本機資料。

錢包描述符、xpub、助記詞與 PSBT 差在哪？

資料	主要用途	不能直接推論的事情
助記詞	依相應標準與密語重建金鑰來源	不一定自動包含腳本、多簽政策或所有帳戶設定
xpub 等延伸公鑰	推導其範圍內可公開推導的子公鑰	本身不完整說明應採用哪種腳本規則
公開描述符	表達公開金鑰與輸出腳本設定	不提供原本缺少的私鑰
含私鑰的描述符	表達腳本設定並包含秘密金鑰資料	不可當成普通公開資料分享
PSBT	傳遞特定交易的簽署資料與結果	不等於完整錢包設定或金鑰備份

為什麼有助記詞，仍可能需要其他設定？

助記詞可以協助重建相應的金鑰，但軟體還要知道使用哪個帳戶、哪些分支，以及如何建立原本使用的地址。

常見軟體可能會自動搜尋一些標準設定，因此不少單簽錢包可以順利還原；但這不代表所有錢包、非標準路徑與多簽配置都能自動找回。

金鑰備份的基本差異，可先閱讀助記詞與私鑰介紹。

描述符與 PSBT 如何搭配？

描述符協助錢包辨認資產與建立對應腳本；PSBT 則用來處理某一筆付款的簽署資料。

例如，你可以先把公開描述符匯入協調錢包查看資產，再由該錢包建立 PSBT，交給持有相應金鑰的裝置簽署。具體交易流程可參考 PSBT 離線簽署與廣播教學。

如何看懂描述符？先認識四個部分

一般使用者不需要手動編寫描述符，但理解常見欄位，有助於核對匯入設定。

外層函數：使用哪種輸出規則

常見的描述符片段包括：

語法片段	大致用途
pkh(KEY)	描述 P2PKH 輸出
wpkh(KEY)	描述 P2WPKH 原生 SegWit 輸出
sh(wpkh(KEY))	描述包在 P2SH 中的 P2WPKH 輸出
wsh(SCRIPT)	描述 P2WSH 輸出，其內可放相應腳本
tr(KEY)	描述以指定內部金鑰建立的 Taproot 輸出

表中的 KEY、SCRIPT 是說明用途的佔位文字，不是可直接匯入的完整描述符。Taproot 描述符也可以包含支援的腳本樹等內容，並非只有表中簡化形式。

地址格式的差異，可參考比特幣地址介紹。

金鑰來源：指紋與推導路徑

某些描述符會在金鑰前記錄來源資訊，例如主金鑰指紋與來源路徑，協助相容軟體及裝置對應金鑰。

指紋不是密碼，也不是資產所有權證明；它只是識別資訊之一。路徑則應依來源錢包的完整匯出內容保留，不要從其他教學抄一組數字來替換自己的設定。

想逐層看懂帳戶與地址索引，可延伸閱讀 HD 錢包、BIP32 與推導路徑教學。

分支與範圍：收款、找零及多個地址

部分描述符描述一個固定輸出，另一些則使用萬用索引表達一系列地址。常見帳戶配置會把外部收款與內部找零分開處理，但不能假定所有錢包都使用完全相同的分支安排。

有些匯出會提供兩份描述符，有些使用支援多路徑的語法。接收軟體必須支援對應方式，才能涵蓋預期範圍。

若只匯入收款分支，可能漏掉找零中的資產。這與比特幣找零地址的運作方式有關。

校驗碼：協助發現複製錯誤

描述符後方可以帶有井字號與八個字元的校驗碼，用來協助檢查輸入錯誤。部分軟體或匯入操作會要求它。

校驗碼不是加密，也不是官方認證。即使某份描述符的校驗碼有效，也不代表它屬於你的錢包；他人的描述符或被替換後重新計算校驗碼的內容，同樣可能通過格式檢查。

公開描述符可以分享嗎？

先確認匯出的是哪一種資料，再決定如何保管。

公開描述符：不能單獨簽署，但可能揭露資產

只含公開金鑰與腳本設定的描述符，不會提供缺少的私鑰。取得者可能據此追蹤相應地址、餘額與交易活動，因此仍屬於需要保護的財務隱私資料。

如果目的是建立自己的查看介面，應只交給可信裝置與軟體。公開匯入的功能限制，可參考觀察錢包教學。

含私鑰的描述符：按秘密金鑰資料保護

描述符語法也可以承載私鑰或延伸私鑰，不能把所有 Descriptor 都稱為「公開資訊」。

若目的是匯入觀察錢包，請使用來源產品明確提供的公開匯出流程。不要把不確定內容的描述符貼到搜尋引擎、客服對話或線上檢查工具，也不要僅憑有沒有看到某個前綴就認定安全。

公開描述符使用教學：五步核對匯入

以下以「從自己的來源錢包匯入相容觀察軟體」為情境，不涉及把助記詞輸入新工具。具體按鈕以官方版本為準。

步驟一：確認來源帳戶與地址類型

在原錢包找到要觀察的比特幣帳戶，確認使用過哪些地址類型。若同一個介面合併顯示不同配置的餘額，一次匯出不一定涵蓋全部資產。

步驟二：使用官方公開匯出功能

從帳戶資訊或官方匯出流程取得完整公開描述符。包含校驗碼時一併保留，不要只複製中間的 xpub，或自行刪除路徑與括號。

步驟三：匯入支援格式的接收軟體

使用接收軟體支援的描述符匯入方式，核對解析出的腳本類型及公開金鑰設定。

以 BitBox 的官方 Sparrow 教學為例，可從 BitBoxApp 的帳戶資料複製完整描述符，再於 Sparrow 的描述符編輯功能匯入，接著確認其為觀察設定。這是特定產品組合的流程，不代表每款錢包都有相同選單。

步驟四：同步並比對已知地址與交易

連接設定的資料來源，載入交易紀錄。至少比較一個已知地址及一筆既有交易；若是未使用帳戶，可先比對地址。

僅看到「匯入成功」或「同步完成」，不能證明選對帳戶。若打算使用新介面產生的地址收款，仍應依原本可信的方式核實完整地址。

步驟五：保存必要設定與本機資料

依錢包官方備份方式保留完整設定，記錄帳戶用途及匯出時間。公開描述符不一定包含標籤、交易備註、掃描起點或其他本機設定，這些資料可能需要另外備份。

有了觀察設定後，實際付款仍要由持有相應金鑰的裝置完成簽署。

多簽錢包為什麼更需要保存政策？

以一般 2-of-3 多簽為例，只備份自己那一把金鑰的助記詞，不一定足以重建完整多簽錢包。還需要知道共同簽署者金鑰、門檻、腳本及推導等設定。

描述符可以表達這些政策，但仍要確保匯出完整，且接收錢包支援相應語法。

multi 與 sortedmulti 不能隨意互換

在適用的傳統多簽腳本中，multi 依描述的金鑰順序建立腳本；sortedmulti 則按規則排序公鑰。自行改寫可能產生不同腳本與地址，不能把兩者視為純排版差異。

保存政策有助於重建查詢與協調設定，卻無法補回遺失的必要私鑰。是否還能付款，仍需滿足原本的簽署條件。

還原後餘額不符，先檢查什麼？

現象	可能原因	核對方向
地址與原錢包不同	帳戶、密語、金鑰或腳本規則不同	回到來源設定逐項比對
只看到部分交易	缺少其他地址類型或找零分支	確認完整匯出範圍
描述符無法解析	複製不完整、校驗錯誤或語法不支援	重新完整匯出，確認版本支援
沒有舊交易紀錄	未掃描對應歷史、範圍或資料來源有問題	依軟體說明檢查掃描與同步設定
有餘額但不能簽署	只匯入公開設定，或簽署裝置不匹配	核對持有金鑰的來源裝置
多簽地址不一致	共同金鑰、順序、門檻或腳本不同	使用完整政策備份，避免自行拼湊