为何火狐浏览器安装插件后侧边栏不显示图标？

火狐v128+废弃sidebar_action字段，旧版Manifest V2插件侧边栏图标不显示；需升级至Manifest V3，声明sidebar_panel和sidebarAction权限，并改用service_worker。

火狐浏览器安装插件后侧边栏不显示图标，不是插件没装上，也不是被禁用，而是v128及以上版本彻底废弃了旧版sidebar_action字段，强制要求迁移到Manifest V3架构——旧插件即使启用，图标也不会自动出现在侧边栏或工具栏。

确认插件是否仍处于启用状态

在地址栏输入about:addons→回车→切换到“扩展”标签页→查看目标插件右侧状态是否为“已启用”。

若显示“已禁用”，点击启用后再继续；若显示“已启用”但依然无图标，说明插件未被卸载，只是新版火狐不再识别其注册方式。

手动触发侧边栏入口（临时唤出）

方法一：通过调试命令强制打开
在地址栏输入about:debugging#/runtime/this-firefox→回车→找到对应插件→点击“调试”→切换到Console标签→粘贴并执行：browser.sidebarAction.open();→按回车。

这行命令仅本次生效，能立刻唤出侧边栏；但若报错browser.sidebarAction is not defined，说明插件未声明sidebarAction权限或根本未适配Manifest V3。

方法二：拖拽图标到附加组件栏
点击右上角 ≡ 菜单→选择“定制…”→在左侧“额外工具栏按钮”区域找到该插件图标→将其拖入顶部的“附加组件栏”（地址栏正下方细长栏）→松手→点击右下角“完成”。

【此操作不会恢复原生侧边栏菜单项，仅提供快捷入口】。点击该图标可展开侧边栏，但无法从右键菜单或Ctrl+B调出。

检查并修复插件清单文件（manifest.json）

第一步：确认清单版本
在about:addons页面找到该插件→点击右侧“更多”→查看“详细信息”→找到“清单版本”字段。若显示“Manifest V2”，则【无法在v128+中使用sidebar_action，必须升级至V3】。

第二步：验证权限与字段声明
V3插件必须同时满足两项：manifest.json中含"sidebar_panel": "sidebar.html"，且"permissions"数组中包含"sidebarAction"。缺任一项，browser.sidebarAction API均不可用。

第三步：检查background服务工作线程是否激活
Manifest V3强制使用service_worker替代background script。若manifest.json中仍写"background": {"scripts": ["bg.js"]}，需改为"background": {"service_worker": "sw.js"}，并确保sw.js中监听sidebarAction.onClicked等事件。