以本地為設計前提
Extension.js 在你自己的機器上執行:用 CLI 開發、執行並建置擴充功能。它刻意止於打包。 當打包好的建置準備好上架商店時,下一步是 extension.dev—— 贊助 Extension.js 的那個平台。這條路徑適合誰
- 第一次接觸擴充功能開發: 建立你的第一個擴充功能
- 想用既有範例快速探索: 立刻開始
- 正在挑選起始技術棧: 範本
- 想比較框架(WXT 等): Extension.js vs WXT
事前準備
開始之前,請先用node --version(或 deno --version、bun --version)檢查你的版本。
第一次成功的成果
1
建立或執行一個擴充功能專案
使用
extension create 或選一個範本作為起點。2
啟動 dev 並載入擴充功能
執行
extension dev,並在目標瀏覽器中載入建置輸出。3
驗證更新行為
做一次變更,並確認擴充功能會自動重新載入。
4
建置正式輸出
至少對一種瀏覽器執行
extension build。第一次執行。
extension dev 預設以 chromium 為目標,在一個版本固定的 Chrome for Testing
和隔離設定檔中執行你的擴充功能,絕不碰你平常瀏覽用的瀏覽器。當本機還沒有這個瀏覽器時,
第一次執行會詢問是否下載一次,下載完成後直接繼續進入開發工作階段。回答 n 就不會下載任何東西。你可以隨時執行 npx extension install chromium,
用 --browser=edge 或 --browser=brave 使用已安裝的瀏覽器,用 --chromium-binary <path>
固定任意執行檔,或用 --no-browser 只啟動開發伺服器。非互動式 shell,包括 CI,不會被詢問:
它會印出安裝指令並停止。請見
為什麼 Extension.js 會下載瀏覽器
與 略過受管下載。建議的閱讀順序
後續步驟
- 在指令參考中了解指令選擇。
- 在 Extension configuration 中設定專案預設值。
- 透過工作流程驗證發佈準備是否就緒。

