Chrome 擴充套件匯入教學:ZIP 解壓縮、開發人員模式與手動安裝

Chrome 擴充套件手動匯入教學:解壓縮、開啟開發人員模式、載入未封裝項目

拿到朋友分享、公司內部提供,或從 GitHub 下載的 Chrome 擴充套件,卻發現只有一個 ZIP 壓縮檔,沒有「加到 Chrome」按鈕,該怎麼安裝?

這種情況可以使用 Chrome 的「載入未封裝項目」功能,把電腦上的擴充套件資料夾加入瀏覽器。這篇會從解壓縮開始,帶你找到正確的資料夾、完成匯入,再處理更新與常見錯誤。

適用範圍:Windows、macOS 與 Linux 的電腦版 Chrome。介面名稱可能因版本或語言略有差異。

文章目錄
  1. 步驟一:解壓縮,找到正確的資料夾
  2. 步驟二:開啟 Chrome 擴充功能管理頁面
  3. 步驟三:開啟開發人員模式
  4. 步驟四:載入未封裝項目
  5. 步驟五:開啟「允許使用者指令碼」(套件有要求時)
  6. 步驟六:固定圖示,確認可以使用
  7. 常見問題 QA
  8. 其他延伸閱讀

步驟一:解壓縮,找到正確的資料夾

如果下載的是 .zip,請先使用作業系統的解壓縮功能,把檔案完整解開。再打開解壓後的資料夾,尋找 manifest.json;它是 Chrome 用來辨識擴充套件設定的資訊清單。Chrome 官方:Manifest 資訊清單。

等一下要選的是「直接包含 manifest.json 的那一層資料夾」。以下圖為例,就要選取 my-extension:

HTML 介面示意 · 找到要載入的資料夾
擴充套件資料夾
project-main
my-extension
project-main / my-extension
manifest.json在這一層
popup.html
popup.js
icons
1看到 manifest.json 後,記住目前這一層資料夾名稱。這個範例要選的是 my-extension。
圖一 資料夾結構示意。檔名僅為範例,請以作者提供的內容為準。 實際介面會依 Chrome 版本與作業系統有所不同。

各套件的檔案不會完全相同。重點是找到資訊清單,不需要把檔案改成示意圖中的名稱。

如果解壓後是 project-main/my-extension/manifest.json,就要再往內選到 my-extension,不能只選外面的 project-main。

若專案要求先建置,請依 README 操作,或下載作者提供的可安裝版本。有些專案會把成品放在 dist 或 build,但名稱並不固定;應以作者的安裝說明為準,不能假設每份原始碼 ZIP 都能直接載入。

步驟二:開啟 Chrome 擴充功能管理頁面

在 Chrome 上方的網址列輸入以下內容,再按 Enter:

chrome://extensions/

請貼到顯示網址的位置,不是網頁裡的 Google 搜尋框。這是瀏覽器內部頁面,手動輸入即可。

也可以從右上角「⋮」選單,依序開啟「擴充功能」→「管理擴充功能」。Google 官方:管理擴充功能。

步驟三:開啟開發人員模式

進入管理頁面後,找到右上方的「開發人員模式」(Developer mode)並開啟。頁面上就會出現「載入未封裝項目」等開發用按鈕。Chrome 官方:載入未封裝擴充功能。

HTML 介面示意 · 開啟開發人員模式
chrome://extensions/
擴充功能
1開發人員模式
2載入未封裝項目封裝擴充功能更新
已安裝的擴充功能會列在這裡
① 先開右上角的開關 ② 再按「載入未封裝項目」
這些是示意標記,實際操作請回到 Chrome 的擴充功能管理頁面。
圖二 擴充功能管理頁面示意。開啟開發人員模式後,即可找到載入按鈕。 實際介面會依 Chrome 版本與作業系統有所不同。

使用手動載入的套件時,請保持開發人員模式開啟。Chrome 團隊已調整規則,關閉這個模式會停用透過此頁載入的未封裝擴充套件。Chrome 團隊公告。

步驟四:載入未封裝項目

  1. 按下「載入未封裝項目」(Load unpacked)。
  2. 在檔案選擇視窗中,找到剛才整理好的資料夾。
  3. 選取直接包含 manifest.json 的資料夾,再確認選取。

不用選 ZIP 壓縮檔,也不用單獨點選 manifest.json。Chrome 要讀取的是整個擴充套件目錄。載入成功後,管理頁面會出現該套件的卡片,可查看名稱、版本與啟用狀態。Google 官方:本機測試自訂擴充功能。

HTML 介面示意 · 選取整個資料夾
選取擴充功能資料夾
下載項目
project-main
下載項目 / project-main
my-extension已選取
這個資料夾裡,直接包含 manifest.json 與其他套件檔案。
選資料夾,不是選單一檔案。
Windows 可能顯示「選取資料夾」,macOS 則可能顯示「選取」;依視窗中的確認按鈕完成即可。
圖三 資料夾選擇視窗示意。確認選到正確層級,再按右下角的確認按鈕。 實際介面會依 Chrome 版本與作業系統有所不同。

步驟五:開啟「允許使用者指令碼」(套件有要求時)

如果套件作者要求開啟 script,請到該套件的詳細資料頁面,開啟「允許使用者指令碼」(Allow user scripts)。Chrome 138 以上版本會針對各個套件分開設定。Chrome 官方:允許使用者指令碼設定。

  1. 回到 chrome://extensions/,找到剛載入的套件卡片。
  2. 按下卡片上的「詳細資料」(Details)。
  3. 找到「允許使用者指令碼」,將旁邊的開關打開。
  4. 回到要使用的網頁,重新整理後,再依作者說明啟動套件功能。
HTML 介面示意 · 開啟使用者指令碼
chrome://extensions/
範例工具
先找到剛載入的擴充套件
1詳細資料已啟用
← 範例工具 · 詳細資料
允許使用者指令碼Allow user scripts允許這個套件使用使用者指令碼功能
2
① 按「詳細資料」→ ② 開啟「允許使用者指令碼」
開啟後回到目標網頁重新整理,再使用套件功能。
圖四 使用者指令碼設定示意。開關位於各套件的詳細資料頁面;實際介面以 Chrome 畫面為準。

這個步驟適用於有使用者指令碼功能、且作者要求開啟的套件。如果沒有這個選項,可以先跳過,依作者說明確認需求。手動載入的未封裝套件,仍須保持前面開啟的「開發人員模式」。

步驟六:固定圖示,確認可以使用

匯入成功後,可以按網址列右側的拼圖圖示,找到剛加入的擴充套件,再按旁邊的固定圖示,方便之後開啟。部分套件沒有可固定的圖示,需依作者說明使用。Google 官方:整理工具列中的擴充功能。

HTML 介面示意 · 確認載入完成與固定圖示
chrome://extensions/
載入成功後,會出現套件卡片
範例工具 1.0.0
本機載入的擴充功能
詳細資料移除已啟用
擴充功能
按工具列上的拼圖圖示,打開這個選單
範例工具固定
管理頁面看到卡片 → 確認已啟用 → 從拼圖選單固定圖示。
卡片上的重新載入圖示,則是之後更新套件檔案時會用到的位置。
圖五 載入成功與固定圖示示意。「範例工具」為說明用名稱,請在畫面中找自己的套件。 實際介面會依 Chrome 版本與作業系統有所不同。

接著依作者說明,打開它支援的網站或功能頁面測試。如果它會在網頁上加入按鈕或工具,請重新整理目標網頁,再確認功能是否出現;涉及網頁內容指令碼的更新,需要一併重新載入網頁。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 團隊公告為準。套件自己的建置、登入與設定流程,請另參考作者說明。