data-sort-key 应用连字符或下划线命名（如"user-name"），避免点号；排序值须存于 data-sort-value 中，禁用 innertext 解析；复杂场景用 getattribute 读取，兼容 ie11。
data-sort-key 属性必须是合法的 JavaScript 标识符
直接在元素上写 data-sort-key="user.name" 看似合理，但实际无法被 dataset.sortKey 正确读取——浏览器会把点号转成驼峰，变成 userName，原始结构就丢了。真正能稳定提取嵌套路径的，只有字符串字面量本身。
正确做法是用连字符分隔，比如 data-sort-key="user-name"，再在 JS 里约定映射规则（如 "user-name" → "user.name"），或统一用下划线 data-sort-key="user_name"，后端/前端共用同一套字段命名规范。
- 避免使用
.、[、]、空格等非法字符，否则dataset会静默截断或转换 - 若需支持动态嵌套（如
metadata.tags[0].label），建议改用data-sort-path并配合lodash.get或自定义安全取值函数 - 所有
data-sort-*属性值都应为纯字符串，不要试图塞 JSON 片段（如data-sort-key='{"field":"price","order":"desc"}'），解析成本高且易出错
排序方向控制别只依赖 data-sort-order 的布尔真假
data-sort-order="false" 在 HTML 中仍是真值（非空字符串），Boolean("false") === true。用字符串值做判断时，必须显式比对 "asc" / "desc"，不能靠 !!el.dataset.sortOrder。
更稳妥的方式是预留默认行为：未声明 data-sort-order 时按升序，声明了才检查值；同时接受大小写不敏感匹配，避免因 data-sort-order="ASC" 导致失效。
- 推荐判断逻辑：
const order = (el.dataset.sortOrder || 'asc').toLowerCase() === 'desc' ? -1 : 1 - 如果多个可排序列共存，建议用
data-sort-active="true"单独标记当前主排序项，避免靠data-sort-order多重状态耦合 - 注意：CSS 选择器无法匹配属性值大小写，
[data-sort-order="desc"]不会选中data-sort-order="DESC"
用 getAttribute 而非 dataset 读取带特殊字符的配置值
当需要支持更灵活的配置格式（比如含小数、连字符开头、或数字前缀）时，dataset 会强制标准化键名（如 data-2nd-priority → dataset["2NdPriority"]），不可靠。此时应退回到 getAttribute('data-2nd-priority') 直接读原始字符串。
尤其在实现「多级优先级排序」时，常需类似 data-sort-priority="2" 或 data-sort-priority="-1.5" 的数值型配置，getAttribute 能保留原始格式，后续再用 parseFloat() 安全转换。
- 只要属性名含数字、连字符、下划线开头，或值含前导零（如
"08"），一律优先用getAttribute -
dataset适合简单、规范、无歧义的键值对；复杂配置场景下它只是语法糖，不是可靠接口 - 注意 IE11 不支持
dataset，如需兼容，getAttribute是唯一通用方案
排序函数里别直接用 innerText 做数值比较
用户看到的文本（如 "¥1,299.00" 或 "2024-03-15"）和真实排序依据（1299、Date.parse()）往往不一致。靠 el.innerText 提取再正则清洗，容易漏掉空格、单位、HTML 实体，且性能差（触发重排）。
正确做法是把原始数据存在 data-sort-value 里，比如 <td data-sort-value="1299">¥1,299.00</td>，排序时直取该值，显示仍用 innerText。这样分离关注点，也避免重复解析。
- 日期类建议存时间戳（
data-sort-value="1710489600000"）或 ISO 字符串（"2024-03-15"），而非本地化格式 - 金额类统一转为整数分单位存储（
129900），彻底规避浮点误差 - 如果 DOM 结构动态生成，务必在插入前就写好
data-sort-value，而不是靠 JS 后置计算——否则排序可能取到旧值或空字符串
最麻烦的不是怎么写排序逻辑，而是让不同开发人员往 DOM 里塞的 data-sort-* 属性始终语义一致、格式可控。上线后查一个排序错乱的问题，八成卡在某个 data-sort-key 拼错了下划线，或者 data-sort-value 被 Vue 模板插值漏渲染了。配置化省的是代码，不是约定成本。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
