data属性仅用于服务端渲染时传递静态元信息，需以data-开头、全小写、仅含字母数字和连字符，且不可双向同步。
data 属性不是前后端数据对接的通道，它只适合传递静态、低频、与 DOM 生命周期绑定的元信息。后端渲染时写入、前端只读取不修改，才是安全边界。
data-* 属性在服务端渲染中怎么写才不会被浏览器忽略
服务端输出 HTML 时，data- 属性必须满足三要素：以 data- 开头、后接至少一个字符、命名全小写且只含字母/数字/连字符（-）。比如 data-order-id="1024" 合法，data-OrderId 会被转成 dataset.orderid，data-user_id 则无法通过 dataset.userId 访问。
常见错误现象：
-
data-status="pending"写成了status="pending"→ 浏览器不识别，dataset.status为undefined -
data-api-url="https://api.example.com/v1"中含冒号或斜杠 → 虽然 HTML 解析不报错，但部分旧版 Safari 对含:的data-名支持不稳定，建议避开 - 后端模板里拼接
data-值时未做 HTML 转义 → 如用户昵称含"或，导致属性截断或 XSS 风险
前端 JS 读取 data 属性时，为什么 dataset.userId 是 undefined
根本原因不是 JS 写错了，而是 DOM 上压根没这个属性，或者命名不匹配。浏览器对 data- 属性名的驼峰映射是严格单向的：HTML 中 data-user-id → JS 中 dataset.userId；反过来，dataset.UserId 或 dataset.userid 都无效。
立即学习“前端免费学习笔记（深入）”；
排查要点：
- 用浏览器开发者工具 Elements 面板确认该元素是否真有
data-user-id属性（注意大小写和连字符） - 检查是否误用了
getAttribute("data-userId")—— 这会返回null，因为属性名是data-user-id，不是data-userId - 服务端是否条件渲染漏写了该属性？比如某些订单状态不输出
data-refund-amount - 是否在 JS 执行前 DOM 尚未加载完成？
document.querySelector返回null导致后续读取失败
后端传复杂数据（如对象、数组）能不能直接塞进 data 属性
能存，但不该存。data 属性值永远是字符串，任何结构化数据都得先序列化。更关键的是，它会显著拖慢 DOM 操作性能，尤其当列表项上百、每个都带 data-item-json='{"id":1,"tags":["a","b"]}' 时。
推荐做法：
- 只存必要 ID 或标识符，如
data-item-id="123"，其余数据由前端按需调 API 获取 - 若必须预置少量结构化数据，用
JSON.stringify后写入，前端用JSON.parse(el.dataset.itemJson)解析，但要加 try/catch - 绝对不要把敏感字段（如用户手机号、权限列表）明文塞进
data-—— 它完全暴露在源码里，爬虫和用户都能看到 - 避免在循环中反复读取
dataset，比如list.forEach(el => console.log(el.dataset.id))，应先缓存el.dataset.id到变量再处理
真正容易被忽略的一点：data 属性一旦写入 DOM，就和元素生命周期强绑定。后端改了数据但没刷新页面，前端读到的就是过期值；前端改了 dataset，后端完全无感知。它从来不是双向同步机制，只是单次“快照式”交付。
