webstorm需配置终端path或使用npx/web-ext运行配置来集成web-ext：先确认全局安装路径，修改terminal shell path；或在package.json中添加devdependencies并用npx运行；更推荐创建node.js运行配置，指定web-ext.js路径及参数，支持热重载与跨平台firefox路径适配。
WebStorm 本身不内置 web-ext，但可以无缝集成——关键不是“能不能”，而是“怎么配环境变量、怎么设运行配置、怎么避免路径和 Node 版本冲突”。
web-ext 命令在 WebStorm 终端里报 command not found
这是最常见问题，本质是 WebStorm 的终端没继承系统 PATH，或没识别你全局安装的 web-ext。Node.js 装了、npm install -g web-ext 也执行成功，但在 WebStorm 内置 Terminal 里输 web-ext --help 却提示找不到命令。
解决办法很直接：
- 确认
web-ext确实装好了：which web-ext（macOS/Linux）或where web-ext（Windows CMD），记下输出路径，比如/usr/local/bin/web-ext - 在 WebStorm 中打开 Settings > Tools > Terminal，找到
Shell path，改成你系统默认的 shell（如/bin/zsh或C:\Windows\System32\cmd.exe），别用内置的轻量模式 - 如果仍不行，就绕过 PATH：在 WebStorm Terminal 里直接用完整路径运行，例如：
/usr/local/bin/web-ext run - 更一劳永逸的做法：在项目根目录下建
package.json，把web-ext作为devDependencies安装，然后用npx web-ext run——这样完全不依赖全局安装
在 WebStorm 里用 Run Configuration 启动 web-ext run
比起每次敲命令，用 WebStorm 的运行配置更稳定，还能自动监听文件变化、复用参数、方便调试。
操作步骤如下：
- 菜单栏选 Run > Edit Configurations…
- 点左上角
+→ 选Node.js -
Working directory设为你的扩展根目录（含manifest.json的地方） -
JavaScript file填：node_modules/web-ext/bin/web-ext.js（前提是已npm install --save-dev web-ext） -
Application parameters填：run --source-dir . --firefox=nightly --browser-console（按需调整--firefox值为stable/beta） - 勾选
Allow parallel run，避免改代码时被卡住
保存后，点绿色三角就能一键启动，Firefox 自动拉起，修改代码后 web-ext 会热重载 —— 这比手动切窗口敲命令快得多。
web-ext run 启动后 Firefox 没反应或报错 Failed to start browser
这不是 WebStorm 的问题，而是 web-ext 找不到 Firefox 可执行文件，尤其在 macOS 和 Windows 上路径不标准时高频发生。
典型现象包括：
- 终端卡在
Starting Firefox...几十秒后失败 - 错误信息里出现
ENOENT或Cannot find Firefox binary - 明明 Firefox 已安装，但
web-ext就是不认
解决方式分平台：
-
macOS：Firefox 默认装在
/Applications/Firefox.app，但web-ext需要具体二进制路径，填参数：--firefox=/Applications/Firefox.app/Contents/MacOS/firefox -
Windows：常见路径是
C:\Program Files\Mozilla Firefox\firefox.exe或C:\Users\{user}\AppData\Local\Mozilla Firefox\firefox.exe，建议用双引号包裹全路径传入：--firefox="C:\Program Files\Mozilla Firefox\firefox.exe" -
Linux：一般没问题，但如果用 Snap 安装的 Firefox，得用
firefox --no-sandbox启动，此时加参数：--firefox-binary=firefox --firefox-profile /tmp/firefox-webext-dev
调试弹窗（popup）或后台脚本时看不到 console.log
很多人以为打开浏览器控制台就能看到 popup 的日志，其实 popup 是独立上下文，它的 console 不在主页面控制台里。
正确做法是：
- 右键点击浏览器工具栏上的扩展图标 → 选 Inspect Popup（Firefox 里叫 “检查弹出窗口”），这会打开一个专属 DevTools，里面才能看到 popup 页面的
console输出 - 后台脚本（background script）的日志，在
web-ext run启动时加--browser-console参数，然后按Ctrl+Shift+J（Win/Linux）或Cmd+Opt+J（macOS）打开浏览器全局控制台，筛选源为background - 如果用了 Manifest V3，注意
background是 service worker，它不能长期驻留，console.log只在事件触发时有效，且不会持续显示在控制台——必须在事件回调里打日志，并配合chrome.runtime.onInstalled等钩子验证是否触发
真正容易被忽略的是：WebStorm 的 JavaScript Debug 配置对 popup 页面基本无效，不要浪费时间配断点；老实用浏览器自带的 Inspect Popup + 控制台组合，效率最高。
