localStorage.setItem()未生效主因是键名错误、值未转字符串或页面未加载完就执行；读取返回NULL属正常首次运行现象，需用parseInt(getItem()||”0″,10)安全转换；多模式高分应分键存储而非嵌套对象；ios无痕模式会禁用localStorage，须加try/catch兜底。
localStorage.setItem() 保存分数时为什么没生效
常见原因是键名写错、值没转成字符串，或者在页面未加载完成时就执行存储。localStorage 只接受字符串值，直接存数字或对象会变成 "[Object Object]" 或 "undefined"。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
localStorage.setItem("gameHighScore", score.toString())确保传入字符串 - 避免使用空格或特殊字符作键名，推荐全小写加下划线，如
"space_shooter_highscore" - 在游戏结束逻辑里调用，别放在定时器或动画帧中频繁写入（没必要，也影响性能）
- 可加一层判断：只有新分数 > 原高分时才更新，减少无效操作
读取 localStorage.getItem() 返回 null 怎么办
不是数据丢了，是第一次运行时根本没存过，getItem() 就返回 null。不能直接拿这个值做数值比较，否则 null > 100 是 false，但 null == 0 也是 false，容易误判。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
parseInt(localStorage.getItem("gameHighScore") || "0", 10)提供默认值并安全转换 - 不要用
==比较getItem()结果，它可能是null、"0"、"123"，类型不一致 - 调试时可在控制台手动输
localStorage.getItem("gameHighScore")看真实值
多个关卡/模式需要分开存高分？用不同 key 还是嵌套对象
用不同 key 更简单、更可靠。localStorage 本身不支持嵌套结构，存对象必须 jsON.stringify()，读取时再 json.parse() —— 一旦 JSON 格式出错（比如多了一个逗号），parse() 就抛错，导致整个读取失败，高分变 0。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 按模式区分 key：例如
"racing_easy_high"、"racing_hard_high" - 如果模式很多，可用统一前缀 + 动态拼接，如
`${gameMode}_high` - 真要存结构化数据（比如带时间戳、用户名），再考虑
JSON.stringify()，但务必包 try/catch
用户清缓存或换设备后高分消失正常吗
完全正常。localStorage 是纯前端、单域名、单浏览器的本地存储，不跨设备、不联网、不清除就不会丢。它不是后端数据库，也不等同于“云存档”。
如果你的“高分记录”需要持久跨端，那就不是 localStorage 能解决的——得配简单后端接口 + 用户标识（哪怕只是随机 device_id），或者接入微信开放数据域、Firebase Auth 等轻量方案。但对绝大多数 html5 小游戏来说，本地存档就是“关掉页面再打开还在”，这就够了。
容易被忽略的一点：iOS safari 在无痕模式下会禁用 localStorage，调用 setItem() 直接抛错。上线前最好加个兜底检测：
try { localStorage.setItem('test', 'ok'); localStorage.removeItem('test'); } catch (e) { console.warn('localStorage unavailable'); // 切到内存变量暂存，或提示用户关闭无痕模式 }