> ## 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>

## 参数与 flag

| flag / 参数             | 作用                                                   | 默认值 |
| --------------------- | ---------------------------------------------------- | --- |
| `[browser-name]`      | 移除单个受管理浏览器，例如 `chrome`、`chromium`、`edge` 或 `firefox` | 未设置 |
| `--browser <browser>` | 浏览器参数的显式 flag 形式                                     | 未设置 |
| `--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 teardown 中使用 `--all`**：测试运行后清理受管理的浏览器。
* **先用 `--where` 确认**：在脚本化批量卸载之前先确认会被移除的内容。
* `uninstall` 对系统浏览器是安全的，只会移除 Extension.js 受管理的缓存文件夹。

## 行为说明

* 如果你设置了 `EXT_BROWSERS_CACHE_DIR`，卸载会使用这个自定义的缓存根目录。

## 下一步

* 用 [`install`](/docs/commands/install) 重新安装受管理的浏览器。
* 在 [`dev`](/docs/commands/dev) 与 [`start`](/docs/commands/start) 中查看浏览器目标设置。
* 了解 [运行其他浏览器](/docs/browsers/running-other-browsers)：通过自定义二进制路径。