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');
// 切到内存变量暂存，或提示用户关闭无痕模式
}
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
