dev、start 與 preview 中使用執行檔旗標與 extension.config.*。
運作方式
使用下列其中一個旗標:--chromium-binary <path>--gecko-binary <path>(別名:--firefox-binary <path>)
執行檔功能
| 選項 / 鍵 | 用途 |
|---|---|
--chromium-binary <path> | 啟動自訂的 Chromium 系列瀏覽器執行檔。 |
--gecko-binary <path> | 啟動自訂的 Gecko 系列瀏覽器執行檔。 |
--firefox-binary <path> | --gecko-binary 的別名。 |
browser.<target>.chromiumBinary | 在設定中設定預設的自訂 Chromium 執行檔。 |
browser.<target>.geckoBinary | 在設定中設定預設的自訂 Gecko 執行檔。 |
commands.<name>.chromiumBinary | 設定特定指令使用的自訂 Chromium 執行檔。 |
commands.<name>.geckoBinary | 設定特定指令使用的自訂 Gecko 執行檔。 |
CLI 範例
start 與 preview 使用。
在 extension.config.* 中設定
目標對應行為
執行檔提示會對應到引擎目標:chromiumBinary→chromium-basedgeckoBinary/firefoxBinary→gecko-based
可用的瀏覽器
可透過執行檔旗標執行的常見瀏覽器:| 瀏覽器名稱 | 類型 | CLI 旗標 | 官方網站 |
|---|---|---|---|
| Brave | Chromium-based 瀏覽器 | --chromium-binary | brave.com |
| Opera | Chromium-based 瀏覽器 | --chromium-binary | opera.com |
| Vivaldi | Chromium-based 瀏覽器 | --chromium-binary | vivaldi.com |
| Waterfox | Gecko-based 瀏覽器 | --gecko-binary | Waterfox |
| Firefox Developer Edition | Gecko-based 瀏覽器 | --gecko-binary | firefox.com |
重要限制
chromium-based需要有效的chromiumBinary路徑。gecko-based/firefox-based需要有效的geckoBinary路徑。- 無效路徑會立即失敗,並回報明確的 CLI/執行階段錯誤。
build不接受執行檔旗標。基於執行檔的啟動方式只能用在dev、start與preview。
最佳實務
- 執行檔搭配明確的瀏覽器目標:使用
--browser=chromium-based或--browser=gecko-based表達清楚意圖。 - 使用絕對路徑:避免 shell 路徑解析造成的問題。
- 在持續整合(CI)Runner 中固定版本:讓瀏覽器執行檔路徑在自動化檢查中保持確定性。
- 小心搭配設定檔/旗標:沿用具名瀏覽器目標所使用的設定檔與旗標策略。

