“扩展可能已损坏”提示表明Chrome在校验环节拒绝加载，主因是路径含中文/空格、_metadata文件夹未重命名、manifest.json含BOM头或manifest_version格式错误、Windows压缩属性启用等；须先开启开发者模式，再解压CRX为ZIP、纯英文路径加载、修正_metadata为metadata、保存manifest.json为UTF-8无BOM并确保manifest_version为数字3。
谷歌浏览器离线安装插件时提示“扩展可能已损坏”，说明文件已写入但Chrome在校验环节主动拒绝加载——它卡在路径、格式、元数据或策略任一关，而非插件本身失效。
确认开发者模式已开启
所有离线加载操作都依赖此开关，未开启则后续步骤全部失败。
在Chrome地址栏输入 chrome://extensions/ 回车，进入扩展管理页。
右上角找到“开发者模式”开关，点击使其变为蓝色；若为灰色，必须点一下才生效。
【没有开发者模式，任何本地加载都会立即报错】。
把CRX重命名解压后加载（最常用）
新版Chrome（130+）已停用CRX直装机制，直接拖拽.crx文件大概率触发“CRX_HEADER_INVALID”错误。解压成文件夹是绕过校验的稳定路径。
第一步：将下载的插件文件（如 tampermonkey.crx）重命名为 tampermonkey.zip。
第二步：用7-Zip将其完整解压到一个全新空文件夹，路径必须为纯英文且不含空格或特殊符号（推荐 C:\ext\tm ）。
第三步：回到 chrome://extensions/ 页面，点击左上角“加载已解压的扩展程序”按钮。
第四步：在弹出窗口中精准选中刚才解压出的整个文件夹（不是 manifest.json，也不是.zip文件），点击“选择文件夹”。页面刷新后若出现新条目且无红色报错，即成功。
处理_metadata文件夹报错
如果加载后页面顶部弹出红字错误：“Cannot load extension with file or directory name _metadata”，说明Chrome检测到系统保留命名的文件夹，必须手动修正。
打开你解压出来的那个文件夹，在内部查找是否存在名为 _metadata 的子文件夹。
若存在，直接将其重命名为 metadata（仅删掉开头下划线，大小写和拼写一个字母都不能改）。
返回 chrome://extensions/ 页面，点击刚加载插件右侧的“重新加载”图标（↻），再重新执行一次“加载已解压的扩展程序”，选同一文件夹即可。
修复manifest.json格式问题
方法一：用VS Code打开扩展根目录下的manifest.json文件，确认第一行不能有BOM头；另存为“UTF-8 无BOM”格式。
方法二：检查 "manifest_version" 字段值是否为数字3（不是字符串"3"或3.0），否则Chrome解析失败却只报“损坏”。
方法三：验证所有 content_scripts、background、icons 等字段中引用的文件路径是否真实存在，且大小写完全一致——Windows不区分大小写但Chrome校验时区分。
解除Windows压缩属性并重新打包
右键扩展所在文件夹→属性→高级→取消勾选“压缩内容以节省磁盘空间”→点击“确定”→再点“应用”→选择“将更改应用于此文件夹、子文件夹和文件”。
完成后必须重新打包：用7-Zip选中文件夹内全部内容（不选文件夹本身），压缩为ZIP，确保 manifest.json 在压缩包最外层。
