dataset读取data-*属性为undefined的最常见原因是命名不规范，浏览器只识别全小写加连字符（如data-user-id），其他形式如data_user_id、data-2024-start、data-API-Key等均会导致解析失败或访问异常。
dataset读取data-*属性为什么总是undefined
最常见原因是HTML里写了data-userId或data_user_id，浏览器压根不解析——它只认全小写+连字符的命名，比如data-user-id。一旦命名违规，DOM里就不存在这个属性，dataset.userId自然返回undefined。
还有几类隐蔽问题：
-
data-2024-start这种数字开头的，不能用点号访问，得写element.dataset["2024Start"] -
data-api--endpoint（双连字符）会被转成apiEndpoint，语义丢失且不可靠 - 属性名含大写字母（如
data-API-Key）会被转成全小写键名apikey，不是apiKey
dataset赋值后DOM没更新，刷新页面就丢数据
dataset是个只读代理，不是双向绑定。你写element.dataset.count = "5"，只是改了内存副本；原始HTML里的data-count值根本没变，刷新后还是旧的。
真正要持久化，必须用原生API：
立即学习“前端免费学习笔记（深入）”；
- 设值：
element.setAttribute('data-count', '5') - 删值：
element.removeAttribute('data-count') - 清空整个dataset：
Object.keys(element.dataset).forEach(k => element.removeAttribute('data-' + k))
混用更危险：先dataset.foo = 'a'，再setAttribute('data-foo', 'b')，后续dataset.foo仍返回'a'——它缓存了初始映射，不会重拉DOM值。
dataset拿到的值永远是字符串，类型转换容易翻车
哪怕HTML里写data-active="false"或data-price="9.99"，dataset.active和dataset.price拿到的仍是字符串"false"和"9.99"。
容易踩的坑：
- 直接拿
dataset.count === 0做判断，结果永远是false - 用
Boolean("false")判断布尔值，结果是true（非空字符串都为真） - 没
JSON.parse()就当对象用，报TypeError: Cannot read property 'theme' of undefined
安全写法：
- 数字：
Number(el.dataset.count) || 0或+el.dataset.count - 布尔：
el.dataset.isActive === "true" - 对象：
JSON.parse(el.dataset.config || "{}")，并加try-catch
遍历所有data属性时for...in或Object.keys()失效
element.dataset是DOMStringMap对象，不是普通对象，它不继承自Object.prototype，所以for...in、Object.keys()、Object.entries()都拿不到它的键值对——这些方法会返回空数组或什么也不遍历。
正确做法是把它转成真正的对象再操作：
- 简单转对象：
Object.fromEntries(Object.entries(element.dataset)) - 兼容旧版：
Array.from(element.attributes).filter(attr => attr.name.startsWith('data-')).reduce((acc, attr) => { acc[attr.name.slice(5)] = attr.value; return acc; }, {})
注意：转出来的键名仍是驼峰格式（userId），不是原始HTML里的data-user-id。
