Chrome扩展提示manifest.json缺失或不可读错误如何修复

按以下优先级逐一排查：

1. 基础文件问题排查 #

• 确认文件位置：manifest.json必须直接放在你加载扩展时选择的根目录下，不能嵌套在src、dist这类子文件夹中
• 确认文件名完全正确：
  • 拼写必须为manifest.json，注意全小写，Windows系统需关闭“隐藏已知文件类型扩展名”，避免实际文件为manifest.json.txt导致识别失败
  • 大小写敏感场景（macOS/Linux、WSL环境）下，首字母大写的Manifest.json会被判定为不存在
• 确认文件编码：将文件保存为UTF-8无BOM格式，不要使用GBK、UTF-8带BOM格式，否则Chrome无法解析
• 确认文件权限：不要把扩展目录放在需要管理员权限的系统路径、正在同步的云盘目录、加密目录中，避免文件被锁定无读取权限

2. 配置格式错误修复 #

你提供的配置中存在Manifest V3字段类型错误：icons字段在Manifest V3规范中为对象类型，不是数组，原有写法会导致解析失败直接触发不可读报错，修正后的完整配置如下：

{
  "name": "HytesCord SuperBlack",
  "short_name":"SuperBlack",
  "description": "This browser extension enables the Discord mobile AMOLED Super Black theme in your discord browser.",
  "version": "2.0.2",
  "manifest_version": 3,
  "permissions": ["storage", "activeTab", "scripting"],
  "action": {
    "default_popup": "popup.html"
  },
  "icons": {
    "48": "/images/hytesImages/HytescordIcon_48b.png",
    "128": "/images/hytesImages/HytescordIcon_128b.png"
  }
}

注意：icons字段不需要额外声明type属性，直接按尺寸映射路径即可

3. 隐藏问题排查 #

如果上述修改后仍报错：

• 全选复制修正后的配置内容，删除原manifest.json，新建纯文本文件重新粘贴内容后保存，避免原文件混入零宽空格、BOM头等不可见特殊字符
• 验证文件可读性：直接把manifest.json拖入Chrome空白页面，如果能正常显示JSON结构化内容，说明文件本身可读无异常
• 回到Chrome扩展管理页，点击对应扩展卡片的刷新按钮重新加载，不要重复选择目录加载，避免旧缓存干扰

内容的提问来源于stack exchange，提问作者HunterTheDev