应从API层过滤无用字段而非隐藏列，统一用小写短横线格式的data-column属性标识列，同步控制thead/tbody/tfoot显隐，通过CSS类切换显示状态。

重构前先确认：隐藏列是否真该“隐藏”而非“移除”

很多团队把“隐藏列”当权宜之计——后端多传了字段，前端不敢删，就用 display: none 盖住。但这样会拖慢渲染、增加内存占用、干扰可访问性（屏幕阅读器仍可能读出内容）。真正该重构的，是数据流本身：如果某列在所有场景下都不需要展示（比如内部 ID、审计时间戳），就该从 API 响应里过滤掉，而不是藏在 DOM 里。

用 data-column 替代索引式隐藏逻辑

现有代码若靠 td:nth-child(4) 或 row.cells[3] 控制显隐，必须重写。这类写法一加新列就失效，且无法应对条件渲染（比如某行缺字段导致 cells 长度不一致）。

DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

下载

• 给每列单元格统一加 data-column="user-id"，包括 <th>、所有 <code><td>、以及 <code><tfoot> 中对应项 <li>值必须全小写+短横线，避免空格或大写（<code>lastLoginTime ❌ → last-login-time ✅）
• Vue/React 中需显式透传：:data-column="'user-id'" 或 data-column={item.column}，别依赖框架默认行为

隐藏动作必须同步作用于 <thead>、<code><tbody>、<code><tfoot><p>只操作 <code><tbody> 的 <code><td> 而忽略 <code><thead> 的 <code><th>，浏览器会强制对齐列数——可能补空单元格、压缩宽度，导致表头悬空或边框断裂，且各浏览器表现不一致。 <ul> <li>一次选中整列：<code>document.querySelectorAll('[data-column="email"]')

不要分两次查 th 和 td，避免漏掉 <tfoot> 或动态插入的新行 <li>新行插入时，确保其 <code><td> 带相同 <code>data-column 和初始类（如 .hidden-column）

用 CSS 类切换，别碰 style.display

直接写 el.style.display = 'none' 会覆盖原生 display: table-cell，恢复时若漏写或写错（比如写成 'block'），表格语义就崩了——整行塌缩、换行、错位都可能发生。

立即学习“前端免费学习笔记（深入）”；

• CSS 规则只需一句：.hidden-column { display: none; }
• JS 只负责增删类：els.forEach(el => el.classList.toggle('hidden-column'))
• 别用 visibility: hidden ——它保留布局空间，列宽残留，相邻列的 padding 和边框间距会异常
• 若用 Shadow DOM，确认样式穿透：:host ::slotted(.hidden-column) 或全局样式表

重构最难的不是改代码，而是清理历史包袱：那些被 colspan 跨过的隐藏列、嵌在 <dialog></dialog> 里的表格、被 React key 机制反复重排的行——这些地方一动，显隐逻辑就得重新验证。