安全修改data-*属性必须用setAttribute()，因dataset只读且不更新DOM；命名须全小写加连字符，值恒为字符串需手动转换，不可用于状态管理。
安全修改节点的 data 属性数据，关键在于区分“HTML 属性”和“DOM 数据属性”，并选用语义正确、兼容性强、不触发意外行为的方式。直接操作 data 属性本身（如 node.data = 'xxx'）只适用于 文本节点（Text Node），而日常开发中绝大多数场景指的是 自定义 data-* 属性（比如 data-id、data-user）。下面分两类说明：
文本节点的 data 属性操作（较少见但需明确）
文本节点（nodeType === 3）确实有 data 属性，它是其内容的原始字符串表示。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 读取：
textNode.data或textNode.nodeValue（两者等价） - 修改：
textNode.data = '新内容'—— 简单直接，但注意这会完全替换整个文本内容，不支持局部编辑 - 更安全的局部操作建议用
replaceData()、insertData()等方法，避免破坏相邻节点结构
元素节点的 data-* 自定义属性操作（最常用）
对 <div data-status="pending"></div> 这类元素，应使用标准 DOM 方法或 dataset API，而非直接赋值 element.data（该属性不存在且无效）。
-
推荐方式：用
dataset（现代、语义清晰、自动处理驼峰转换）
例如：el.dataset.userId = '123'→ 自动映射为data-user-id="123"；读取时el.dataset.userId会自动转成小写连字符格式 -
兼容性兜底：用
getAttribute()/setAttribute()
例如：el.setAttribute('data-uid', '456')；适合需要动态拼接属性名、或处理含特殊字符（如点号、空格）的旧式命名 - 避免直接写
el['data-xxx']或el.dataXxx—— 这些不是标准属性，不可靠，也不反映真实 HTML 结构
安全要点总结
- 先确认目标节点类型：
node.nodeType === 3才能安全访问data；否则是元素节点，走dataset或setAttribute - 修改前检查节点是否存在，防止
undefined报错：if (el) el.dataset.status = 'done' - 对用户输入或外部数据做基础校验（如过滤 XSS 风险字符），尤其当
data-*值后续用于 innerHTML 或 eval 类操作时 - 不要依赖
data属性存储敏感信息 —— 它在 HTML 源码中可见，不具备保密性
