> ## Documentation Index
> Fetch the complete documentation index at: https://extension.js.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 用於移除受管理瀏覽器的 Uninstall 指令

> 從 Extension.js 快取中移除受管理的瀏覽器執行階段。只影響由 Extension.js 安裝的瀏覽器,不會影響系統瀏覽器。

使用 `uninstall` 從 Extension.js 快取中移除受管理的瀏覽器執行階段。

它只會移除 Extension.js 安裝在其受管理快取根目錄中的瀏覽器,不會動到系統的 Chrome、系統的 Edge 或任何安裝在該快取之外的瀏覽器。

## 何時使用 `uninstall`

* 你想釋出受管理瀏覽器佔用的磁碟空間,因為已不再需要。
* 你想重設某個受管理瀏覽器的安裝,讓下次 `install` 時強制重新下載。
* 你正在清理持續整合(CI)的快取,或切換瀏覽器目標。

## 標準用法

單一瀏覽器使用位置引數形式:

<CodeGroup>
  ```bash npm theme={null}
  extension uninstall <browser>
  ```

  ```bash pnpm theme={null}
  extension uninstall <browser>
  ```

  ```bash yarn theme={null}
  extension uninstall <browser>
  ```

  ```bash bun theme={null}
  extension uninstall <browser>
  ```

  ```bash bun theme={null}
  extension uninstall <browser>
  ```
</CodeGroup>

使用 `--all` 移除所有受管理的瀏覽器目標。

## 用法

<CodeGroup>
  ```bash npm theme={null}
  extension uninstall [browser-name] [options]
  ```

  ```bash pnpm theme={null}
  extension uninstall [browser-name] [options]
  ```

  ```bash yarn theme={null}
  extension uninstall [browser-name] [options]
  ```

  ```bash bun theme={null}
  extension uninstall [browser-name] [options]
  ```

  ```bash bun theme={null}
  extension uninstall [browser-name] [options]
  ```
</CodeGroup>

## 引數與旗標

| 旗標 / 引數               | 用途                                                   | 預設值 |
| --------------------- | ---------------------------------------------------- | --- |
| `[browser-name]`      | 移除單一受管理瀏覽器,例如 `chrome`、`chromium`、`edge` 或 `firefox` | 未設  |
| `--browser <browser>` | 上述瀏覽器引數的明確旗標形式                                       | 未設  |
| `--all`               | 移除 Extension.js 快取中所有受管理的瀏覽器執行階段                     | 停用  |
| `--where`             | 印出解析後的快取根目錄,或特定瀏覽器的受管理路徑                             | 停用  |

## 範例

### 移除受管理的 Chrome for Testing

```bash theme={null}
extension uninstall chrome
```

### 移除所有受管理的瀏覽器

```bash theme={null}
extension uninstall --all
```

### 顯示 Firefox 的受管理移除路徑

```bash theme={null}
extension uninstall firefox --where
```

## 最佳實務

* **在 CI 收尾使用 `--all`**,在測試後清理受管理的瀏覽器。
* **先使用 `--where`**,在大量移除前確認會被清掉的內容。
* 對系統瀏覽器來說,`uninstall` 是安全的;它只會移除 Extension.js 受管理的快取資料夾。

## 行為說明

* 如果你設定了 `EXT_BROWSERS_CACHE_DIR`,uninstall 會使用該自訂快取根目錄。

## 後續步驟

* 用 [`install`](/docs/commands/install) 重新安裝受管理的瀏覽器。
* 在 [`dev`](/docs/commands/dev) 與 [`start`](/docs/commands/start) 中了解瀏覽器目標。
* 了解 [執行其他瀏覽器](/docs/browsers/running-other-browsers) 並使用自訂執行檔路徑。