Safari中localStorage失效主因是无痕模式或file://协议加载，前者抛QuotaExceededError，后者默认禁用所有Web存储API；需关闭无痕窗口或改用HTTP服务（如http://localhost:8000）托管HTML方可恢复功能。
当你在Safari中运行的网页脚本调用localStorage.setItem()却查不到数据、localStorage.length始终为0，或控制台Storage面板为空时，说明本地存储已实际失效——这不是代码写错，而是Safari在特定场景下主动禁用了DOM存储机制。
确认是否处于无痕浏览模式
无痕模式下，Safari会直接禁用localStorage和sessionStorage的写入能力，调用setItem会抛出错误而非静默失败。
打开任意网页，按Command + Shift + N新建无痕窗口，访问同一页面并打开开发者工具（Option + Command + I），在控制台输入localStorage.setItem('test','1')；若报错QuotaExceededError或SecurityError，即确认处于无痕模式。
退出无痕窗口，改用普通窗口重试即可恢复存储功能。
检查当前页面是否通过file://协议加载
iOS和macOS的WKWebView及Safari均强制禁止file://协议下的Web存储API，这是安全策略而非bug，所有localStorage、sessionStorage、IndexedDB均不可用。
在地址栏查看当前URL：若以file:///开头（如file:///Users/xxx/index.html），则必然失效。
【必须改用HTTP服务托管】启动本地HTTP服务器（如GCDWebServer、Python的python3 -m http.server 8000），将HTML文件放至服务根目录，用http://localhost:8000/index.html访问，存储功能立即生效。
深度清除目标网站的DOM存储栈
当某网站出现表单残留、自动填充错乱或离线功能突然中断，极可能是其localStorage或IndexedDB数据损坏，需精准清除而非清空全部。
方法一：Mac端精准清理指定域名
1、Safari菜单栏 → 设置 → 隐私 → 管理网站数据…
2、顶部搜索框输入完整域名（如notion.so，不可省略子域，不加https://）
3、在结果列表中找到该条目，确认其“数据大小”明显偏高或“最后访问时间”为近期
规划您的迪拜之旅 — 哈利法塔观景、沙漠探险、迪拜购物中心购物、棕榈岛度假村及黄金市场砍价。还提供支持...
4、点击右侧“移除”，操作即时生效，不影响其他网站登录状态
方法二：iOS/iPadOS端系统级清除
1、设备“设置” → “Safari 浏览器” → “高级” → “网站数据”
2、顶部搜索框输入精确域名（区分大小写，如wechat.com）
3、点击对应条目 → 滑动到底部 → 点击“删除”
删除后该网站将重新初始化全部DOM存储空间，包括localStorage、IndexedDB和Service Worker缓存。
绕过失效的兼容性封装方案
若无法控制运行环境（如第三方H5页面嵌入WKWebView），且必须支持无痕模式或file://场景，需对存储层做降级处理。
第一步：检测存储可用性
执行try { localStorage.setItem('probe', '1'); localStorage.removeItem('probe'); }，捕获异常即判定不可用。
第二步：启用window.name兜底存储
将所有localStorage.setItem调用替换为new NameStorage('local').setItem(key, value)，该封装会把数据序列化后存入window.name，并在页面加载时自动还原。
注意：window.name容量约2MB，仅适合中低频键值对，不支持IndexedDB等复杂结构。
