chrome.storage.sync加载已解压扩展时跨设备不同步问题咨询

1. 本地加载未打包扩展的机制限制 #

你观察到的已发布版本同步正常、本地解压加载版本不同步是Chrome的默认机制：Chrome不会对通过「Load Unpacked（加载已解压的扩展程序）」方式安装的开发版扩展开启storage.sync云端同步能力，只有从Chrome网上应用店正式发布安装的扩展才会触发跨设备同步逻辑。本地开发阶段仅能验证存储的本地读写功能，同步逻辑需要上传至应用商店安装正式版本测试。

2. 现有代码存在逻辑错误 #

即使使用正式发布版本，你当前的代码也无法正常读写指定键的存储数据：

• 存储方法属性名硬编码：chrome.storage.sync.set({key : item})写法中，对象的键会被识别为固定字符串key，而非你传入的动态参数key，需要使用ES6动态属性名语法修改
• 读取方法返回值无效：回调函数内的return不会将结果返回到getItems函数外部，需要通过回调传递结果或者封装为Promise使用。

修正后的代码示例 #

// 存储方法：用动态属性名写入指定键
function storeItems(item, key) {
  chrome.storage.sync.set({[key] : item}, () => {
    // 可选：加错误捕获
    if (chrome.runtime.lastError) {
      console.error('存储失败：', chrome.runtime.lastError)
    }
  })
}

// 读取方法：Promise封装支持async/await调用
function getItems(key) {
  return new Promise((resolve) => {
    chrome.storage.sync.get([key], (result) => {
      resolve(result[key])
    })
  })
}

// 调用示例：
// await storeItems('测试内容', 'userName')
// const val = await getItems('userName')

其他排查项 #

• 确认扩展的manifest.json文件中已声明storage权限："permissions": ["storage"]
• 确认两台设备登录的是同一个谷歌账号，且Chrome设置中开启了扩展同步选项
• 确认存储的数据未超出storage.sync配额限制：单条数据最大8KB，总存储最大100KB，超出配额会导致写入静默失败。

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