範本提供的能力
- 可用的專案結構: 從可運作的 manifest、scripts 和原始碼配置起步。
- 針對技術棧的設定: 依框架與執行環境需求挑選範本。
- 更快上手: 幾分鐘內就能從想法走到可執行的擴充功能。
- 一致的預設值: 減少不同專案與團隊成員之間的設定差異。
快速使用
<slug> 替換成你想要的範本名稱。
可用的範本
挑選符合你專案的技術棧預設。每張卡片都會建立一個最小、可執行、附帶可運作manifest.json 的擴充功能。
JavaScript
TypeScript
Svelte
Vue
Preact
React
運作方式
當你執行create --template=<slug> 時,Extension.js 會抓取所選範本、建立專案檔案,並可選擇性地安裝相依套件。
只有 javascript 範本內建於 CLI 中,所以它可以離線建立,完全不需要網路請求。它也是省略 --template 時的預設範本。其他所有名稱都會在建立時下載範本目錄的封存檔。
該目錄包含 6 個群組、大約 50 個範本:starters、sidebar、content scripts、new tab、toolbar action 與特殊資料夾。執行 extension create --help 可以看到全部名稱。
不在目錄中的名稱會以 E_TEMPLATE_NOT_FOUND 失敗,而且什麼都不會建立。下載失敗則會回報為下載錯誤,所以網路問題絕不會看起來像打錯字。
可重現的專案建立
範本語料庫固定在 examples 儲存庫的某個不可變 commit 上。同一個範本建立兩次一定會產生相同的檔案,已出貨的 CLI 也絕不會追著一個會移動的分支跑。 你可以指向另一份語料庫:EXTENSION_CREATE_TEMPLATE_REF 接受分支、tag 或 commit SHA。把它設為 main 就會恢復追隨浮動分支的行為。
從 URL 建立專案
--template 也接受用 GitHub URL 或 ZIP URL 取代目錄中的範本名稱:
更多範本
在 examples 儲存庫中找到官方範本原始碼: 範本資料夾名稱會直接對應到--template=<slug>。
最佳實務
- 用範本快速建立你的專案結構。
- 從你已熟悉的技術棧範本開始。
- 選擇最符合專案需求的瀏覽器擴充功能情境。

