必须用<ol>而非<ul>或手写编号,因其原生支持顺序语义、屏幕阅读器识别、自动编号及start属性续编;嵌套步骤需严格<ol><li>结构,避免闭合错误和非法子元素。

直接用 <ol> 就能正确展示安装步骤,语义清晰、可访问性好、浏览器自动编号,不需要手动写 1. 2. 3.
为什么必须用 <ol> 而不是 <ul> 或纯数字文本
安装步骤有强顺序依赖——“先解压再配置,不能颠倒”,<ol> 明确传达这种语义,屏幕阅读器会读出“第1项”“第2项”,搜索引擎也更容易识别流程结构。用 <ul> 或手打 1. 文本,既丢失语义,又增加维护成本(改顺序就得全重编号)。
- 手写编号:改第2步时,后面所有数字都要手动调整
- 用
<ul>+ CSS 模拟编号:无法被辅助技术识别为有序流程 -
<ol>:浏览器原生支持跳步、重启编号、倒序等逻辑,一步到位
start 属性解决“接续上一节”的编号断层
比如文档前半部分讲环境准备,用了 <ol><li>安装 Node.js</li><li>安装 Git</li></ol>,后半部分才是安装步骤,你想从第3步开始编号——直接加 start="3":
<ol start="3"> <li>下载安装包</li> <li>运行 <code>installer.exe</code></li> <li>按向导完成配置</li> </ol>
注意:start 是 HTML 属性,只接受整数;不要写成 start="three" 或带单位的值。
立即学习“前端免费学习笔记(深入)”;
CSS 的 list-style-type 比 HTML type 更可靠
虽然 HTML 支持 <ol type="A">,但它的取值有限(仅 1、A、a、I、i),且在某些旧浏览器或嵌套场景下行为不一致。现代项目推荐用 CSS 控制:
- 小写字母:
list-style-type: lower-alpha; - 大写罗马数字:
list-style-type: upper-roman; - 避免用
lower-greek等非标准值,兼容性差 - 若需自定义图标(如 ▶ 或 ✅),先设
list-style: none,再用::before { content: "▶ "; }
嵌套步骤和常见踩坑点
安装步骤里常有子步骤(比如“配置环境变量”下分“Windows”和“macOS”两套操作),这时要嵌套 <ol>,而不是硬塞 <div> 或 <p>:
<ol>
<li>解压安装包</li>
<li>配置环境变量
<ol>
<li>Windows:添加到 <code>PATH</code></li>
<li>macOS:写入 <code>~/.zshrc</code></li>
</ol>
</li>
</ol>
容易踩的坑:
- 漏闭
</li>:浏览器可能把后续内容吞进上一项,导致编号错乱或样式塌陷 - 在
<ol>里直接放<div>:HTML 规范只允许<li>作为直接子元素,否则解析不可控 - 用
display: flex包裹<ol>:默认项目符号会消失,必须给每个<li>单独设置list-style-position: inside或改用伪元素
最稳妥的做法是:结构用 <ol> 和 <li> 严格嵌套,样式用 CSS 统一控制,不依赖 HTML 属性做复杂定制。



















