table-layout: auto 默认逐列扫描最长不可换行字符串定宽，易致英文/URL列失控；table-layout: fixed 才可控自适应，需配合明确 table 宽度、col 元素定义列宽及 word-break 等换行控制。

table-layout: auto 是默认行为，但不等于“自动适应”

浏览器对 table 元素默认使用 table-layout: auto，但它的真实逻辑是：逐列扫描所有单元格内容，找出每列中“不可换行的最长字符串”，以此作为该列最小宽度。这意味着：

• 如果某列有 "xxxxxxxxxxxxxxxxxxxx"（一长串无空格英文/数字），整列会被撑得很宽
• 中文因天然可断行，通常表现“正常”，但英文、URL、ID 类字段极易失控
• width 属性在 auto 模式下仅作 min-width 使用，无法强制压缩
• 表格总宽若未设（如没写 width: 100% 或固定像素值），它会按内容总和撑开，溢出父容器

常见错误现象：table 在小屏上横向滚动、列宽严重不均、td 内文字跑出边界却不换行。

解决建议：

• 确保父容器有明确宽度（如 div { width: 100%; }）
• 给 table 加 width: 100%（不是 auto）
• 对易撑开的列（如日志、ID、URL）加 word-break: break-all 或 word-wrap: break-word
• 避免给 th/td 直接设 width，它在 auto 下优先级低且语义混乱

table-layout: fixed 才能真正“可控地自适应”

table-layout: fixed 不是让列“随内容缩放”，而是让列宽由你预设的规则决定，再让内容去适配——这才是工程中真正可落地的“自适应”。

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

关键前提有三个：

• table 必须有明确宽度（width: 100% 或 width: 800px），否则浏览器退回到 auto 行为
• 列宽必须来自 <col> 元素，或第一行的 <th>/<code><td> 的 <code>width 属性（注意：是 HTML width 属性，不是 CSS width）
• 后续所有行的 td 上写的 width 都会被忽略

示例结构：

<table style="width: 100%; table-layout: fixed;">
  <col width="120">
  <col width="30%">
  <col width="auto"> <!-- 无效，fixed 下不支持 auto -->
  <thead><tr><th>ID</th><th>Name</th><th>Remark</th></tr></thead>
  <tbody><tr><td>123456789</td><td>Alice</td><td>long remark text...</td></tr></tbody>
</table>

容易踩的坑：

• 混用 min-width / max-width：在 fixed 模式下它们常被跳过，不起作用
• 把 width 写在 td 的 style 里：浏览器只认第一行的 HTML width 属性或 <col>
• 忘记外层容器加 overflow-x: auto：小屏时整表仍会溢出，需包裹一层带滚动的容器

为什么 <col> 是最稳的列宽控制方式

<col> 是 HTML 中唯一专为“列级样式”设计的语义化元素，它在 table-layout: fixed 下拥有最高优先级，且不依赖渲染顺序。


anything-to-html
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
下载

它的好处包括：

• 宽度声明清晰独立，不会和单元格内容产生耦合
• 支持 px、%、em，但不支持 fr 或 auto
• 可配合 span 属性一次定义多列（如 <col span="2" width="200">）
• 即使表格内容为空，列宽也严格按定义生效

对比之下：

• 第一行 th 的 width 属性虽可用，但一旦表头被 JS 动态替换或重绘，就容易丢失控制
• td 上的 width 属性只在首行有效，且易被误写到后续行，造成调试困难

一个稳定写法模板：

<table style="width: 100%; table-layout: fixed;">
  <col width="80">
  <col width="25%">
  <col width="150">
  <col width="1fr"> <!-- 会被忽略，别这么写 -->
  <thead><tr><th>No</th><th>Title</th><th>Date</th><th>Content</th></tr></thead>
  <tbody>...</tbody>
</table>

内容溢出和换行必须手动干预

无论 auto 还是 fixed，浏览器默认都不会主动折断长单词或 URL。中文因字间天然可断，问题不明显；但英文、数字串、Base64、哈希值等会直接冲出单元格。

必须显式加以下任一规则：

• word-break: break-all：粗暴在任意字符间断行（适合日志、ID 字段）
• word-wrap: break-word（等价于 overflow-wrap: break-word）：优先在空格处断，不得已才在词内断（更适合描述类文本）
• white-space: normal：确保不被 nowrap 覆盖（检查是否继承了全局样式）

同时注意：

• overflow: hidden 在 td 上只裁剪内容，不触发换行，需配合上述断行属性
• table-layout: fixed 下，如果内容高度超出 td 高度，且未设 height，它会撑高整行；若设了固定 height，则内容会被剪切

最简健壮组合：

td, th {
  word-break: break-all;
  white-space: normal;
}

复杂点在于：不同列对换行策略的需求可能完全不同。比如“ID 列”要 break-all，“姓名列”要保留完整姓名不拆，“备注列”要优先按空格断。这种差异必须靠 class 区分，不能全表统一样式。