二稿核验说明(2026-10-15):本文为“河洛序”教程二稿,已按官方规范与文档修订。旧实验日志单独标为“一稿留存输出”,不代表本次在Windows上的复跑;本次环境与结果见本批核验记录。示例中的“星河笔记”、账号、订单、价格与政策均为虚构教学数据。
一句话定义
CSS用选择器和声明指定页面表现。多个声明竞争时,浏览器依照层叠规则,综合适用性、来源与重要性、层、内联样式、优先级及后续顺序等因素决定结果;specificity不是整个算法。
为什么重要
- “我写的样式为什么不生效”几乎都是层叠问题;理解优先级才能有效排错,而不是到处加
!important。 - 盒模型与 Flex/Grid 布局决定了页面在不同屏幕上的表现。
- AI 生成的前端代码样式冲突很常见,读懂层叠才能审得动。
原理 / 图解
CSS Cascading and Inheritance Level 5:https://www.w3.org/TR/css-cascade-5/;Selectors Level 4 优先级计算:https://www.w3.org/TR/selectors-4/#specificity-rules;MDN 优先级:https://developer.mozilla.org/zh-CN/docs/Web/CSS/Specificity
(简化版:完整规则还包括样式来源(用户代理/用户/作者)、@layer 层与作用域等。)
| 概念 | 要点 |
|---|---|
| 优先级 | (id, class/属性/伪类, 元素/伪元素) 三元组按位比较;#buy (1,0,0) 胜过任意多个 class |
| 继承 | color、font-size 等文字属性默认继承;border、width、padding 不继承 |
| 盒模型 | content-box:width 只算内容;border-box:width 含 padding 与 border |
| Flexbox | 一维布局;flex: 1 与 flex: 2 按比例分配剩余空间 |
适用边界与核验要点
正文的小型比较器仅适用于同一作者来源、有限选择器且没有层、动画、过渡和复杂作用域的演示。!important不是无条件最高,来源与层在重要声明中也有顺序,过渡中的值另有优先规则。Flex按增长因子分配的是可分配空间,实际尺寸还受basis、最小内容、padding和gap影响。jsdom不实现完整布局,某一旧版本的颜色结果不能推广成所有版本都如此。
本次检索核对的主要依据(2026-10-15):
- W3C:CSS Cascade Level5:来源、重要性、层与优先级顺序。
- MDN:层叠介绍:层叠完整因素及重要声明顺序。
可运行示例
Python仅预测本例有限选择器,再与本机Chrome或Edge的计算结果和jsdom对照。设置BROWSER_BIN可指定浏览器,保持其原有sandbox。下方旧日志不代表本次浏览器版本。
文件:examples/web/css_demo.html
<!DOCTYPE html>
<html><head><meta charset="utf-8"><style>
/* 层叠:同一个按钮被 5 条规则同时命中 */
button { color: green; }
.btn { color: orange; }
.btn.primary { color: blue; }
#buy { color: red; }
.card button { color: purple; }
.note { color: gray !important; }
/* 盒模型 */
.a { width: 200px; padding: 20px; border: 5px solid; box-sizing: content-box; }
.b { width: 200px; padding: 20px; border: 5px solid; box-sizing: border-box; }
/* Flex 布局 */
.row { display: flex; width: 600px; gap: 0; }
.side { flex: 1; } .content { flex: 2; }
/* 继承 */
.card { font-size: 20px; border: 1px solid; }
</style></head>
<body>
<div class="card">
<button id="buy" class="btn primary">购买</button>
<button id="buy2" class="btn primary note" style="color: black">购买2</button>
<span id="child">我继承了 font-size,但不继承 border</span>
</div>
<div class="a" id="boxA">A</div><div class="b" id="boxB">B</div>
<div class="row"><div class="side" id="side">侧栏</div><div class="content" id="content">正文</div></div>
<pre id="out"></pre>
<script>
const q = s => document.querySelector(s), cs = s => getComputedStyle(q(s));
const w = s => q(s).getBoundingClientRect().width;
q("#out").textContent = JSON.stringify({
buy: cs("#buy").color, buy2: cs("#buy2").color,
child_font: cs("#child").fontSize, child_border: cs("#child").borderTopWidth,
boxA: w("#boxA"), boxB: w("#boxB"), side: w("#side"), content: w("#content")
});
</script>
</body></html>
# 文件:examples/16_css.py
"""CSS 层叠与优先级:用 Python 计算选择器优先级并预测胜出规则,再交给真实浏览器(Chrome 无头模式)和 jsdom 计算,对比结果。"""
import re, json, subprocess, tempfile, pathlib, html as H, os, shutil
RULES = [("button", "green", False), (".btn", "orange", False), (".btn.primary", "blue", False),
("#buy", "red", False), (".card button", "purple", False), (".note", "gray", True)]
def specificity(sel):
ids = len(re.findall(r"#[\w-]+", sel)); cls = len(re.findall(r"\.[\w-]+|\[[^\]]+\]|:(?!:)[\w-]+", sel))
tags = len([t for t in re.split(r"[\s>+~]+", re.sub(r"[#.][\w-]+", " ", sel)) if t.strip()])
return (ids, cls, tags)
print("① 选择器优先级 (id, class, 元素):")
for s, c, imp in RULES: print(f" {s:<14} {specificity(s)} color:{c}{' !important' if imp else ''}")
def winner(el_classes, el_id, inline=None):
cand = []
for order, (s, c, imp) in enumerate(RULES):
parts = s.split()[-1]
need_id = re.findall(r"#([\w-]+)", parts); need_cls = re.findall(r"\.([\w-]+)", parts); tag = re.match(r"^[a-z]+", parts)
if (not need_id or need_id[0] == el_id) and set(need_cls) <= el_classes and (not tag or tag.group() == "button"):
cand.append(((imp, 0, specificity(s), order), c, s)) # 先比 !important,再比内联,再比优先级,最后比出现顺序
if inline: cand.append(((False, 1, (0, 0, 0), 99), inline, "style=\"…\"(内联)"))
return max(cand)
for el, cls, idd, inline in [("#buy", {"btn", "primary"}, "buy", None), ("#buy2", {"btn", "primary", "note"}, "buy2", "black")]:
k, c, s = winner(cls, idd, inline); print(f"② Python 预测 {el}: 胜出规则 {s} → {c}")
web = pathlib.Path(__file__).resolve().parent / "web"
page = web / "css_demo.html"
browser = os.environ.get("BROWSER_BIN") or shutil.which("google-chrome") or shutil.which("msedge")
if not browser:
edge = pathlib.Path(r"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe")
browser = str(edge) if edge.is_file() else None
if not browser: raise RuntimeError("设置 BROWSER_BIN 为已安装的 Chrome/Edge 可执行文件")
with tempfile.TemporaryDirectory() as prof:
result = subprocess.run([browser, "--headless=new", "--disable-gpu", "--no-first-run", f"--user-data-dir={prof}",
"--window-size=1200,800", "--dump-dom", page.as_uri()], capture_output=True, text=True,
encoding="utf-8", errors="replace", timeout=60,
creationflags=subprocess.CREATE_NO_WINDOW if os.name == "nt" else 0)
if result.returncode:
raise RuntimeError(f"浏览器退出码 {result.returncode}:{result.stderr[-2500:]}")
dom = result.stdout
match = re.search(r'<pre id="out">(.*?)</pre>', dom, re.S)
if not match: raise RuntimeError("浏览器未返回预期页面,请检查 BROWSER_BIN 与本地浏览器启动日志")
chrome = json.loads(H.unescape(match.group(1)))
assert chrome["buy"] == "rgb(255, 0, 0)" and chrome["buy2"] == "rgb(128, 128, 128)", chrome
assert chrome["boxA"] == 250 and chrome["boxB"] == 200, chrome
ver = pathlib.Path(browser).name
js = """const {JSDOM}=require('jsdom');const fs=require('fs');const d=new JSDOM(fs.readFileSync('css_demo.html','utf8')).window;
const c=s=>d.getComputedStyle(d.document.querySelector(s));console.log(JSON.stringify({buy:c('#buy').color,buy2:c('#buy2').color,child_font:c('#child').fontSize}))"""
jsd = json.loads(subprocess.run(["node", "-e", js], cwd=web, capture_output=True, text=True, encoding="utf-8", check=True).stdout)
print(f"\n③ {ver} 实际计算结果:")
for k, v in chrome.items(): print(f" {k:<13} {v}")
print("④ jsdom 24 计算结果(无布局引擎,宽度无法计算):", jsd)
一稿留存输出
以下日志按一稿保留,来自一稿声称的原环境;不是本次复跑结果。二稿代码改动后可产生不同输出,实际复跑状态以本批核验记录为准。
① 选择器优先级 (id, class, 元素):
button (0, 0, 1) color:green
.btn (0, 1, 0) color:orange
.btn.primary (0, 2, 0) color:blue
#buy (1, 0, 0) color:red
.card button (0, 1, 1) color:purple
.note (0, 1, 0) color:gray !important
② Python 预测 #buy: 胜出规则 #buy → red
② Python 预测 #buy2: 胜出规则 .note → gray
③ Google Chrome 154.0.8037.97 实际计算结果:
buy rgb(255, 0, 0)
buy2 rgb(128, 128, 128)
child_font 20px
child_border 0px
boxA 250
boxB 200
side 200
content 400
④ jsdom 24 计算结果(无布局引擎,宽度无法计算): {'buy': 'rgb(128, 0, 128)', 'buy2': 'rgb(0, 0, 0)', 'child_font': ''}
- ① ② 按钮
#buy被 5 条规则命中,#buy的优先级 (1,0,0) 最高,预测为红色;#buy2有内联color: black,但.note带!important,预测为灰色。 - ③ Chrome 154 的计算结果与预测一致:
rgb(255, 0, 0)红、rgb(128, 128, 128)灰。 - ③ 继承:
<span>继承了.card的font-size: 20px,但边框宽度是0px——border 不继承。 - ③ 盒模型:同样
width: 200px,content-box实际宽 250(200 + 2×20 padding + 2×5 border),border-box实际宽 200。很多重置样式(如 Tailwind 的 preflight)默认全局使用border-box正是为此https://tailwindcss.com/docs/preflight。 - ③ Flex:600px 容器按 1:2 分为 200 与 400。
- ④ 一稿实验记录:一稿所用jsdom得到不同的颜色和继承结果,说明该次实现不能覆盖本例的完整层叠要求。不能据此推断其他版本会给出相同结果;布局仍应由真实浏览器验证。涉及样式与布局的测试应使用真实浏览器(Playwright、Puppeteer 或无头 Chrome),jsdom 适合 DOM 结构与事件逻辑的测试。
- 说明:本例的 Python 预测器只处理了这几个选择器的最后一段,不是完整的选择器匹配实现。
自测
问题: 两个元素flex分别为1和2,是否在任何内容下宽度都恰好1:2?
参考答案: 不是。还要考虑flex-basis、min-width/min-content、边距、间隙和可分配空间。本例条件简化后得到200与400。
常见误区
- “
!important能解决一切”:它只是把冲突升级到另一层,之后需要按来源、层、重要性及优先级处理,继续堆叠important会增加维护成本,最终无法维护。 - “10 个 class 能胜过 1 个 id”:不能,优先级按位比较,不是十进制加和。
- “内联样式优先级最高”:会被作者样式表里的
!important覆盖(见#buy2)。 - “用 jsdom 跑的样式测试通过了就没问题”:见 ④。
与 AI 开发的关系
- 让 AI 生成前端时,约定一种样式方案(如 Tailwind 原子类、CSS Modules)能显著减少层叠冲突。
- 无头浏览器渲染网页后再提取正文/截图,是 RAG 抓取动态网页、多模态模型“看网页”的常用方式;本例的
--dump-dom就是最简单的形式。 - 检查网页中被 CSS 隐藏的文本(
display:none、font-size:0、颜色与背景相同),可以发现针对 AI 爬虫的隐藏指令。
延伸阅读
- MDN CSS 布局教程:https://developer.mozilla.org/zh-CN/docs/Learn/CSS/CSS_layout
- CSS Tricks Flexbox 指南:https://css-tricks.com/snippets/css/a-guide-to-flexbox/
- jsdom 已知限制(无布局):https://github.com/jsdom/jsdom#unimplemented-parts-of-the-web-platform
尚未验证的范围
- 有限选择器预测器不实现完整CSS算法;当前浏览器复跑状态见核验记录,旧jsdom差异不外推其他版本。
本次示例运行范围
2026-10-15:通过。独立临时配置的Edge无头布局断言及jsdom对照;预测器只覆盖有限选择器。
“一稿留存输出”保留原字,不是二稿代码新生成的结果;其原结论须结合二稿修订与边界阅读。
配套代码与核验资料