拿到朋友分享、公司內部提供,或從 GitHub 下載的 Chrome 擴充套件,卻發現只有一個 ZIP 壓縮檔,沒有「加到 Chrome」按鈕,該怎麼安裝?
這種情況可以使用 Chrome 的「載入未封裝項目」功能,把電腦上的擴充套件資料夾加入瀏覽器。這篇會從解壓縮開始,帶你找到正確的資料夾、完成匯入,再處理更新與常見錯誤。
適用範圍:Windows、macOS 與 Linux 的電腦版 Chrome。介面名稱可能因版本或語言略有差異。
文章目錄
步驟一:解壓縮,找到正確的資料夾
如果下載的是 .zip,請先使用作業系統的解壓縮功能,把檔案完整解開。再打開解壓後的資料夾,尋找 manifest.json;它是 Chrome 用來辨識擴充套件設定的資訊清單。Chrome 官方:Manifest 資訊清單。
等一下要選的是「直接包含 manifest.json 的那一層資料夾」。以下圖為例,就要選取 my-extension:
各套件的檔案不會完全相同。重點是找到資訊清單,不需要把檔案改成示意圖中的名稱。
如果解壓後是 project-main/my-extension/manifest.json,就要再往內選到 my-extension,不能只選外面的 project-main。
若專案要求先建置,請依 README 操作,或下載作者提供的可安裝版本。有些專案會把成品放在 dist 或 build,但名稱並不固定;應以作者的安裝說明為準,不能假設每份原始碼 ZIP 都能直接載入。
步驟二:開啟 Chrome 擴充功能管理頁面
在 Chrome 上方的網址列輸入以下內容,再按 Enter:
chrome://extensions/
請貼到顯示網址的位置,不是網頁裡的 Google 搜尋框。這是瀏覽器內部頁面,手動輸入即可。
也可以從右上角「⋮」選單,依序開啟「擴充功能」→「管理擴充功能」。Google 官方:管理擴充功能。
步驟三:開啟開發人員模式
進入管理頁面後,找到右上方的「開發人員模式」(Developer mode)並開啟。頁面上就會出現「載入未封裝項目」等開發用按鈕。Chrome 官方:載入未封裝擴充功能。
這些是示意標記,實際操作請回到 Chrome 的擴充功能管理頁面。
使用手動載入的套件時,請保持開發人員模式開啟。Chrome 團隊已調整規則,關閉這個模式會停用透過此頁載入的未封裝擴充套件。Chrome 團隊公告。
步驟四:載入未封裝項目
- 按下「載入未封裝項目」(Load unpacked)。
- 在檔案選擇視窗中,找到剛才整理好的資料夾。
- 選取直接包含
manifest.json的資料夾,再確認選取。
不用選 ZIP 壓縮檔,也不用單獨點選 manifest.json。Chrome 要讀取的是整個擴充套件目錄。載入成功後,管理頁面會出現該套件的卡片,可查看名稱、版本與啟用狀態。Google 官方:本機測試自訂擴充功能。
Windows 可能顯示「選取資料夾」,macOS 則可能顯示「選取」;依視窗中的確認按鈕完成即可。
步驟五:開啟「允許使用者指令碼」(套件有要求時)
如果套件作者要求開啟 script,請到該套件的詳細資料頁面,開啟「允許使用者指令碼」(Allow user scripts)。Chrome 138 以上版本會針對各個套件分開設定。Chrome 官方:允許使用者指令碼設定。
- 回到
chrome://extensions/,找到剛載入的套件卡片。 - 按下卡片上的「詳細資料」(Details)。
- 找到「允許使用者指令碼」,將旁邊的開關打開。
- 回到要使用的網頁,重新整理後,再依作者說明啟動套件功能。
開啟後回到目標網頁重新整理,再使用套件功能。
這個步驟適用於有使用者指令碼功能、且作者要求開啟的套件。如果沒有這個選項,可以先跳過,依作者說明確認需求。手動載入的未封裝套件,仍須保持前面開啟的「開發人員模式」。
步驟六:固定圖示,確認可以使用
匯入成功後,可以按網址列右側的拼圖圖示,找到剛加入的擴充套件,再按旁邊的固定圖示,方便之後開啟。部分套件沒有可固定的圖示,需依作者說明使用。Google 官方:整理工具列中的擴充功能。
卡片上的重新載入圖示,則是之後更新套件檔案時會用到的位置。
接著依作者說明,打開它支援的網站或功能頁面測試。如果它會在網頁上加入按鈕或工具,請重新整理目標網頁,再確認功能是否出現;涉及網頁內容指令碼的更新,需要一併重新載入網頁。Chrome 官方:重新載入擴充功能。
常見問題 QA
匯入失敗,或找不到「載入未封裝項目」,怎麼辦?
先確認已開啟「開發人員模式」,再將 ZIP 解壓縮,選取直接包含 manifest.json 的資料夾。若資訊清單仍有錯誤,把完整訊息提供給套件作者;公司或學校的電腦則請管理員確認政策。Google 官方設定說明。
若錯誤指出 Manifest V2 不受支援,請向作者取得 V3 新版。Chrome 官方相容性說明。
載入成功卻沒有反應,怎麼辦?
確認套件已啟用,重新整理目標網頁,並從「詳細資料」檢查網站存取權。若卡片出現「錯誤」(Errors)按鈕,可把訊息與操作步驟交給作者排查。Google 官方管理說明。
一定要開啟「允許使用者指令碼」嗎?
有使用這項功能且作者要求的套件才需要。請到套件的「詳細資料」開啟;若沒有這個選項,依作者說明確認需求即可。手動載入的套件仍要保持「開發人員模式」開啟。Chrome 官方指令碼設定。
如何更新?每次開啟 Chrome 都要重新匯入嗎?
一般不用每次重新匯入。更新時,把完整新版放回原本的資料夾,按套件卡片上的重新載入圖示,再重新整理目標網頁。請保留套件資料夾,更新前先依作者說明備份重要設定。Chrome 官方更新方式。
如何暫停使用或移除套件?
在 chrome://extensions/ 關閉該套件的啟用開關,即可暫停使用。確定不用時,按「移除」並確認;如有需要保留的資料,先依作者說明備份。Google 官方移除方式。
操作時最容易卡住的是資料夾層級。只要先確認 manifest.json 在哪一層,再回到擴充功能管理頁面載入,就能按照同一套流程處理作者提供的本機安裝版本。
參考文件以文中連結的 Google Chrome 說明中心、Chrome for Developers 與 Chrome 團隊公告為準。套件自己的建置、登入與設定流程,請另參考作者說明。
