data属性在querySelector中按普通HTML属性匹配，需严格遵循CSS选择器语法：属性名区分连字符、值含特殊字符必须加引号、大小写敏感；错误示例[data-id=123]应写为[data-id="123"]。
data属性在querySelector中的实际匹配方式
HTML data- 属性本身不参与CSS选择器语义，但能被 querySelector 和 querySelectorAll 直接用作属性选择器。关键不是“用data属性查找”，而是把它当普通HTML属性来查——浏览器根本不管它是不是data-开头。
常见错误是写成 document.querySelector('[data-id=123]') 却没加引号，导致值含空格、连字符或数字开头时解析失败；或者误以为 data-user-id 能用 [data-user_id] 匹配（下划线 ≠ 连字符）。
- 必须用方括号语法：
[data-xxx]、[data-xxx="value"]、[data-xxx^="prefix"] - 属性名严格区分连字符：
data-user-id≠data-user_id - 值含特殊字符（如空格、点、斜杠）必须用引号包裹：
[data-path="/api/v1/users"] - 大小写敏感：HTML中
data-Mode="dark"不能用[data-mode="dark"]匹配（除非设为data-mode）
data属性与JavaScript操作的配合要点
通过dataset读写data-属性看似方便，但要注意驼峰转换规则和同步时机——它和getAttribute/setAttribute不是实时镜像关系。
比如<div data-user-id="100"></div>，el.dataset.userId 可读可写，但el.dataset["user-id"] 会报错；而el.setAttribute('data-user-id', '200') 之后，el.dataset.userId 才会更新。这意味着：用querySelector查到元素后，别假设dataset一定反映最新值，尤其在动态修改后立即查询时。
立即学习“前端免费学习笔记（深入）”；
- 批量设置多个
data-属性，用setAttribute比逐个赋dataset更可靠 -
dataset自动过滤非data-前缀属性，但getAttribute不会——查兼容性旧属性时别依赖dataset - IE11不支持
dataset，需降级用getAttribute('data-xxx')
避免data属性查找性能陷阱
把data-当数据库字段用很危险：querySelectorAll('[data-status="active"][data-type="card"][data-priority="high"]') 看似精准，实则触发全量遍历，比加class或用id慢一个数量级。
真正影响性能的不是data-本身，而是选择器复杂度和DOM规模。Chrome DevTools 的 “Rendering” 面板里勾选“Paint flashing”就能看出这类选择器频繁触发重排重绘。
- 高频操作（如滚动监听、动画帧内）禁用带多个
data-条件的querySelectorAll - 优先用
class做状态标记，data-只存不可见元数据（如data-api-url、data-tracking-id） - 需要按
data-快速索引时，自己维护Map缓存：const cache = new Map(); cache.set(el.dataset.id, el);
服务端渲染（SSR）中data属性的常见断层
Next.js、Nuxt等框架服务端生成的data-属性，在hydration（水合）阶段可能被客户端JS覆盖或忽略，导致querySelector查不到预期元素。
典型现象：SSR输出<button data-action="submit">，但React组件挂载后清空了data-action，或者Vue的v-bind动态绑定未同步到初始HTML。此时document.querySelector('[data-action="submit"]') 在useEffect或mounted钩子中执行，可能返回null。
- 服务端必须确保
data-属性稳定存在，且不被客户端逻辑无条件覆盖 - 若需动态控制，改用
data-+ class组合：data-action="submit" class="js-submit-trigger"，用class查更健壮 - Hydration后首次查找，建议加
requestIdleCallback延后或用MutationObserver监听变化
data属性不是万能查找键，它适合存轻量、低频、非样式相关的上下文信息；一旦开始用它做主干筛选逻辑，就该反思DOM结构或状态管理是否合理。
