localStorage.setItem()必须传两个字符串参数，数字/布尔/对象会自动toString()导致类型丢失；getItem()只返回字符串或null，无自动类型转换；需手动解析且注意同源限制、容量上限与无过期机制。
localStorage.setItem() 存字符串时必须传两个字符串参数
直接调用 localStorage.setItem() 时，第一个参数是键名（key），第二个是值（value）——两者都必须是字符串。如果你传入数字、布尔或对象，它会自动调用 .toString()，导致意外结果，比如 true 变成 "true"，null 变成 "null"，而 {a:1} 变成 "[object Object]"。
常见错误场景：用户想存一个 ID 数字 123，写成 localStorage.setItem('id', 123)，虽然能存进去，但取出来是字符串 "123"，后续做严格相等判断（===）就会失败。
正确做法是显式转换或保持类型意识：
- 存数字 ID：用
localStorage.setItem('id', String(123))或localStorage.setItem('id', '123') - 存布尔值：如果需要还原为布尔，不能直接存
true，应存'true'或'false'，读取后手动解析 - 存对象：必须先
JSON.stringify()，否则存的是"[object Object]"
读取时 localStorage.getItem() 总是返回字符串或 null
localStorage.getItem() 没有类型还原能力，哪怕你当初存的是 '42'，它也只负责原样返回这个字符串。不会自动转成数字，也不会把 'true' 变回布尔值。
立即学习“前端免费学习笔记（深入）”；
典型坑点：
-
if (localStorage.getItem('isLoaded') === true)—— 永远不成立，因为返回的是字符串"true"或null -
const count = localStorage.getItem('count') + 1→"42" + 1得到"421"（字符串拼接）
安全读取建议：
- 数字：用
parseInt(localStorage.getItem('count'), 10)或Number(localStorage.getItem('count'))，并检查是否为NaN - 布尔：用
localStorage.getItem('flag') === 'true'（前提是存的时候统一用'true'/'false'） - 对象：先判空，再
JSON.parse()，加try/catch防止解析失败（比如数据被手动篡改过）
localStorage 存储容量和同源限制很实际
大多数浏览器给每个源（origin）分配约 5–10 MB 容量，但它是按字符数算的，不是字节数。中文字符、emoji、Base64 字符串都会快速占满空间。
容易被忽略的限制：
- 不同协议、端口、子域名都算不同源：
http://a.com和https://a.com无法共享localStorage - 无痕模式下部分浏览器会禁用或清空
localStorage（Safari 尤其激进） - 存超长字符串（如未压缩的日志）可能触发 QuotaExceededError，需捕获
DOMException
实操提示：用 localStorage.length 查当前键数量，用 Object.keys(localStorage).reduce((a, k) => a + localStorage[k].length, 0) 估算已用字符数（注意这不等于真实存储开销，但可作粗略参考）。
删除和清空操作要区分 clear() 和 removeItem()
localStorage.removeItem('key') 只删单个键；localStorage.clear() 会清空当前源下所有键值对——没有确认机制，误调用就丢数据。
高频出错场景：
- 在调试时随手写
localStorage.clear()，顺手清掉了用户已保存的偏好设置 - 想删一组 key（如
'user_123_token','user_123_profile'），但没批量处理逻辑，只能一个个removeItem - 用正则匹配删 key？不行——
localStorageAPI 不支持查询，得自己遍历Object.keys(localStorage)
安全删除建议：
- 删前加日志：
console.log('removing', key, localStorage.getItem(key)) - 批量删指定前缀的 key：
Object.keys(localStorage).filter(k => k.startsWith('temp_')).forEach(k => localStorage.removeItem(k)) - 生产环境避免无条件
clear()，宁可用白名单方式逐个删
真正麻烦的不是怎么存，而是忘记它没有过期机制、不跨域、不响应式——一旦写入，就一直躺在那里，直到被代码删掉或用户手动清除。
