開發環境與工具
Chrome Extension 開發不需要額外的框架或建置工具,只要瀏覽器本身與一套編輯器就能開始。這一頁說明需要準備什麼,以及如何在 Chrome 裡載入你自己寫的擴充功能。
需要準備的工具
- Google Chrome:開發與測試都在 Chrome 裡進行,建議使用最新版本以支援完整的 Manifest V3 功能。
- 程式碼編輯器:任何編輯器都可以,建議使用 Visual Studio Code,有良好的 JavaScript/JSON 語法提示。
- 基礎 HTML/CSS/JavaScript 知識:擴充功能的介面與邏輯就是用這三者寫成,沒有特殊語法。
進階開發(例如使用 TypeScript、React 或打包工具)不是必要條件,但等你熟悉基礎架構後,可以視專案需求再加入建置流程。
專案資料夾結構
一個最簡單的擴充功能,資料夾長得像這樣:
my-extension/
├── manifest.json # 設定檔,告訴 Chrome 這個擴充功能是什麼、能做什麼
├── popup.html # 點工具列圖示時顯示的頁面(可省略)
├── popup.js
├── background.js # Background Service Worker(可省略)
└── icons/
├── icon16.png
├── icon48.png
└── icon128.png
不是每個檔案都必須存在,manifest.json 是唯一必要的檔案,其餘元件依需求增減,詳見 核心架構。
開啟開發者模式
Chrome Extension 在開發階段是以「未封裝(unpacked)」的資料夾形式載入,不需要打包成 .zip。步驟如下:
- 在網址列輸入
chrome://extensions,開啟擴充功能管理頁。 - 打開右上角的 開發人員模式(Developer mode) 開關。
- 點擊 載入未封裝項目(Load unpacked),選擇你的專案資料夾。
- 擴充功能會立刻出現在清單與工具列上;之後每次修改程式碼,回到這個頁面點擊該擴充功能卡片上的 重新載入(Reload) 圖示,變更才會生效。
常見誤區
修改 manifest.json 或 background.js 之後,光是重新整理網頁不會套用變更,必須回到 chrome://extensions 手動點擊重新載入。Content Script 則需要連同網頁一起重新整理。
下一步
環境準備好之後,前往 打造第一個擴充功能,實際寫出一個會運作的 Hello World。