把同事发来的扩展文件夹拖进扩展管理页，页面弹出一行红字：此扩展程序可能已损坏。文件夹里明明有文件。这类提示很笼统，可能是压缩包没解压全，也可能是清单文件不合规，得按顺序排。

先确认加载的是文件夹

crx 是打包格式，浏览器不能直接加载，要先解压成文件夹，再点加载已解压的扩展程序，选中那个文件夹。选错层级也常见，必须选到含 manifest.json 的那一层，不能选它的上一层，也不能选到某个子目录。拖拽安装被阻止时，用按钮选目录更稳。

清单文件和浏览器版本

打开 manifest.json 看 manifest_version。旧规范的扩展在新版浏览器上已经被停用，会报类似错误。文件本身有语法错误、编码不是 UTF-8、多个逗号少个引号，同样加载失败。用编辑器的 JSON 校验看一眼就知道，报错还会指到具体行。

  • 路径里有中文或特殊符号，换个纯英文目录再试。
  • 安全软件拦掉了 js 文件，文件在但读不到，先翻隔离区。
  • 解压工具没处理长路径，文件少了几个，换工具重新解压。
  • 从网盘下的包经常被改名，确认扩展名没被改掉。

还不行就看详细报错和策略

扩展页面右上角打开开发者模式，每条扩展下面会有错误详情，点进去能看到具体哪一行出问题。公司电脑还要看策略页，管理员可能禁用了开发者模式或者外部扩展安装，这种报错靠自己改配置解决不了，得找 IT。

排查顺序就是：解压完整、路径正确、清单合规、策略允许。四步都过了还报错，基本能判断这个包本身有问题，别硬装，也别去找来路不明的修复工具。