# 使用 Homebrew, MacPorts, Nix 安装 web-ext

查看 web-ext 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:web-ext
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install web-ext
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install web-ext
```

  证据: MacPorts ports tree: devel/web-ext/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#web-ext
```

  证据: nixpkgs package indexes: pkgs/by-name/we/web-ext/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:web-ext
- **软件包管理器:** Homebrew
- **版本:** 10.5.0
- **来源摘要:** Command-line tool to help build, run, and test web extensions
- **主页:** <https://github.com/mozilla/web-ext>
- **最后更新:** 2026-07-11T11:03:03Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- web-ext (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 10.5.0
## 项目历史与用法

web-ext is Mozilla's command-line tool for building, running, testing, packaging, and signing browser extensions. It grew out of Firefox's WebExtensions transition, giving add-on developers a repeatable CLI workflow around temporary installs, automatic reloads, linting, build artifacts, and submission to addons.mozilla.org.

### 项目历史

Mozilla created the public web-ext repository and npm package in February 2016, while WebExtensions support was still stabilizing in Firefox. Mozilla's April 2016 add-ons blog described WebExtensions in Firefox 48 and pointed to web-ext as the command-line tool that would automate reloads during add-on development.

The 1.0.0 npm release landed in April 2016. By July 2016, Mozilla was already describing web-ext 1.0 as announced and following up with automatic extension reloading and source linting, two features that became central to the tool's everyday value.

The tool continued as part of Firefox Extension Workshop documentation rather than as an abandoned migration helper. By 2026, npm showed a long release history through the 10.x series, while the official command reference documented the current major-version command set.

### 采用历史

web-ext became the standard Mozilla-supported CLI for WebExtension developers because it matches the repetitive tasks of extension work: run the extension in a temporary Firefox profile, watch files, reload after edits, package the source as a zip, and sign or submit builds for addons.mozilla.org.

The broader adoption story is tied to Firefox's move away from legacy extension systems toward the cross-browser WebExtensions model. Even when an extension targets multiple browsers, web-ext remains useful for Firefox-specific testing, AMO signing, Android extension testing, and making Firefox profile state disposable during development.

### 使用方式

The common development loop is to change into an extension source directory and run `web-ext run`, which starts Firefox with the extension temporarily loaded and reloads it after source changes. When the extension is ready, `web-ext build` creates a package and `web-ext sign` can use addons.mozilla.org API credentials to produce or submit signed artifacts.

The tool also supports configuration files and package.json configuration, so teams can put source directories, ignore patterns, signing settings, and other options under version control or local developer configuration. This makes it a small but important bridge between browser-extension code and ordinary command-line build automation.

### 为什么软件包爱好者会关心

web-ext matters in package-manager culture because it turns a browser UI workflow into a scriptable developer tool. Installing it with npm, Homebrew, MacPorts, or Nix lets extension developers use the same shell habits they use for compilers, linters, and bundlers, while still targeting Firefox's extension runtime and AMO publishing requirements.

### 时间线

- 2016-02: Mozilla created the public web-ext repository and first npm package.
- 2016-04: web-ext 1.0.0 was published as Firefox 48-era WebExtensions support stabilized.
- 2016-07: Mozilla documented follow-up work adding automatic reload and linting to the young tool.
- 2024: The npm release stream reached web-ext 8.x, matching a separately documented v8 command reference.
- 2026: npm listed web-ext 10.4.0 as the current package version.

### Related projects

- web-ext sits beside Mozilla's addons-linter, addons.mozilla.org signing APIs, MDN WebExtensions documentation, and browser-specific extension debugging pages such as about:debugging. It is also adjacent to cross-browser extension frameworks that eventually call into browser-specific build or signing steps.

### 来源

- <https://api.github.com/repos/mozilla/web-ext>
- <https://blog.mozilla.org/addons/2016/04/29/webextensions-in-firefox-48/>
- <https://blog.mozilla.org/addons/2016/07/27/linting-and-automatically-reloading-webextensions/>
- <https://extensionworkshop.com/documentation/develop/getting-started-with-web-ext/>
- <https://github.com/mozilla/web-ext>
- <https://www.npmjs.com/package/web-ext>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: ~/.web-ext-config.mjs, ./web-ext-config.mjs, ./.web-ext-config.cjs, ./package.json
- macOS: ~/.web-ext-config.mjs, ./web-ext-config.mjs, ./.web-ext-config.cjs, ./package.json
- Windows: C:\Users\<username>\.web-ext-config.mjs, .\web-ext-config.mjs, .\.web-ext-config.cjs, .\package.json

## Credential files

- Linux: ~/.web-ext-config.mjs, ./web-ext-config.mjs, ./.web-ext-config.cjs, ./package.json
- macOS: ~/.web-ext-config.mjs, ./web-ext-config.mjs, ./.web-ext-config.cjs, ./package.json
- Windows: C:\Users\<username>\.web-ext-config.mjs, .\web-ext-config.mjs, .\.web-ext-config.cjs, .\package.json
## 其他软件包管理器记录

- Nix - web-ext: normalized package name match | nixpkgs package indexes: pkgs/by-name/we/web-ext/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- MacPorts - web-ext: normalized package name match | MacPorts ports tree: devel/web-ext/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/web-ext.yml](https://github.com/mxcl/pkgdb/blob/main/combined/web-ext.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
