本章要回答的问题： Astro 输出的同一套 HTML，怎样在桌面、窄屏、暗色主题和源码定位场景下保持可读？
输入是布局和页面已经写出的元素、class、ARIA 属性以及源码 transformer 放入的行号属性；输出是浏览器计算后的视觉布局。CSS 不读取 .generated、不运行代码，也不决定哪些内容发布。它只把页面结构转换成颜色、尺寸、网格、滚动和焦点反馈。
1. 全局规则先建立主题和页面骨架
site/src/styles/global.css · L1–L1 · 打开完整源码
:root{font-family:Inter,ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Noto Sans CJK SC",sans-serif;color-scheme:light dark;--paper:#f6f8f7;--surface:#fff;--ink:#10232b;--muted:#5c7075;--line:#d9e3df;--accent:#087f79;--soft:#e4f1ed;--code:#0d1720}*{box-sizing:border-box}html{scroll-behavior:smooth;scroll-padding-top:6rem}body{margin:0;background:var(--paper);color:var(--ink);line-height:1.8}a{color:var(--accent);text-decoration:none}a:hover{text-decoration:underline}::selection{background:#a7e5d5;color:#10232b}:focus-visible{outline:3px solid var(--accent);outline-offset:4px}header{position:sticky;top:0;z-index:5;display:flex;align-items:center;justify-content:space-between;gap:1rem;min-height:76px;padding:12px 32px;border-bottom:1px solid var(--line);background:var(--paper)}.brand{display:flex;gap:12px;align-items:center;color:var(--ink)}.brand:hover{text-decoration:none}.brand strong{display:block;font-size:17px;letter-spacing:-.5px}.brand small{display:block;color:var(--muted);font-size:9px;letter-spacing:1.3px}.mark{display:grid;place-items:center;width:39px;height:39px;border-radius:11px;background:var(--accent);color:#fff;font-size:24px;font-weight:800}.top{display:flex;align-items:center;gap:24px;font-size:13px;font-weight:600}.quiet{font:10px ui-monospace,monospace;border:1px solid var(--line);padding:5px 8px;border-radius:5px;color:var(--muted)}.shell{display:grid;grid-template-columns:220px minmax(0,800px) 160px;gap:36px;max-width:1396px;margin:0 auto;padding:44px 28px 80px}.sidebar,.toc{position:sticky;top:108px;align-self:start;max-height:calc(100vh - 135px);overflow:auto}.rail-label,.eyebrow{font-size:11px;letter-spacing:1.5px;color:var(--muted);font-weight:650;text-transform:uppercase}.sidebar nav{display:grid;gap:5px;margin-top:18px}.sidebar nav a{display:flex;gap:10px;align-items:baseline;padding:10px 12px;border-radius:8px;font-size:13px;color:var(--muted)}.sidebar nav a span{font:10px ui-monospace,monospace;opacity:.65}.sidebar nav a[aria-current=page]{color:var(--accent);background:var(--soft);font-weight:700}.source-link{display:block;margin:23px 12px;font-size:13px}.rail-note{border-top:1px solid var(--line);padding-top:20px;color:var(--muted);font-size:12px}.toc nav{display:grid;gap:12px;margin-top:18px}.toc a{font-size:11px;color:var(--muted);line-height:1.65}.toc a:hover{color:var(--accent)}main{min-width:0}h1,h2,h3{line-height:1.35;letter-spacing:-.6px}h1{font-size:36px;margin:14px 0 18px;overflow-wrap:anywhere}h2{font-size:24px}h3{font-size:19px}.lede{color:var(--muted);font-size:16px;line-height:1.85;margin-bottom:32px}.hero{padding:12px 0 35px}.hero h1{font-size:clamp(40px,4.1vw,61px);line-height:1.24;letter-spacing:-2px;margin:20px 0}.hero em{font-style:normal;color:var(--accent)}.actions{display:flex;flex-wrap:wrap;gap:12px;margin-top:27px}.button{display:inline-block;background:var(--accent);border:1px solid var(--accent);border-radius:9px;color:white;padding:10px 17px;font-size:13px;font-weight:650}.button:hover{text-decoration:none;filter:brightness(1.08)}.button.secondary{background:transparent;color:var(--accent);border-color:var(--line)}.command-card{background:var(--surface);border:1px solid var(--line);border-radius:14px;padding:22px 25px;margin:0 0 38px;display:grid;gap:12px}.command-card h2{font-size:18px;margin:8px 0}.command-card pre{margin:0;background:var(--code);color:#e7f2f1;padding:18px;border-radius:9px;font-size:13px;overflow:auto}.command-card code span{color:#91aaa9}.section-heading h2{margin:9px 0 21px}.cards{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:14px}.card{position:relative;background:var(--surface);border:1px solid var(--line);border-radius:12px;padding:22px;color:var(--ink)}.card:hover{text-decoration:none;border-color:var(--accent)}.card-number{font:11px ui-monospace,monospace;color:var(--accent)}.card h3{font-size:17px;margin:13px 0 9px}.card p{font-size:13px;color:var(--muted);margin:0;padding-right:12px}.arrow{position:absolute;right:17px;top:19px;color:var(--accent)}.notice{margin-top:30px;padding:18px 20px;border-left:3px solid var(--accent);background:var(--soft);font-size:13px;color:var(--muted);border-radius:0 8px 8px 0}.prose{font-size:15px;overflow-wrap:anywhere}.prose>h2{margin-top:46px;padding-top:20px;border-top:1px solid var(--line)}.prose h3{margin-top:30px}.prose p,.prose ul,.prose ol{margin:16px 0}.prose li{margin:7px 0}.prose ul,.prose ol{padding-left:25px}.prose a{text-decoration:underline;text-underline-offset:3px}.prose code:not(pre code){background:var(--soft);padding:2px 5px;border-radius:4px;font-size:.88em;overflow-wrap:anywhere}.prose pre,.source-code pre{padding:20px;border-radius:10px;background:var(--code)!important;color:#e7f2f1;font-size:12.5px;line-height:1.75;overflow:auto;max-width:100%;tab-size:4}.prose pre code,.source-code code{white-space:pre-wrap;word-break:normal;overflow-wrap:anywhere}.prose blockquote{margin:20px 0;padding:1px 18px;border-left:3px solid var(--accent);background:var(--soft);color:var(--muted)}.prose table{display:block;max-width:100%;overflow:auto;border-collapse:collapse}.prose th,.prose td{padding:9px 13px;border:1px solid var(--line);font-size:13px}.prose hr{border:0;border-top:1px solid var(--line);margin:30px 0}.filename{font:600 clamp(19px,2.5vw,31px) ui-monospace,monospace;line-height:1.5}.source-list{display:grid;border-top:1px solid var(--line)}.source-list a{display:flex;gap:12px;justify-content:space-between;padding:13px 8px;border-bottom:1px solid var(--line);font-size:13px}.source-list code{overflow-wrap:anywhere}.source-list span{flex-shrink:0;font-size:11px;color:var(--muted)}footer{display:flex;justify-content:space-between;gap:15px;max-width:1396px;margin:auto;padding:22px 30px;border-top:1px solid var(--line);font-size:11px;color:var(--muted)}.mobile-nav{display:none}.skip{position:absolute;left:15px;top:-60px;background:var(--surface);padding:10px;z-index:10}.skip:focus{top:8px}.wide .toc{display:none}.wide{grid-template-columns:220px minmax(0,996px)}@media(prefers-color-scheme:dark){:root{--paper:#071117;--surface:#0c1a21;--ink:#e4efec;--muted:#99afad;--line:#24383d;--accent:#43c8bd;--soft:#113133}.button{color:#071117}.button.secondary{color:var(--accent)}}@media(max-width:1150px){.shell{grid-template-columns:200px minmax(0,1fr);gap:28px}.toc{display:none}.wide{grid-template-columns:200px minmax(0,1fr)}}@media(max-width:760px){header{padding:12px 18px;min-height:68px}.top{gap:12px}.top>a:first-child,.quiet{display:none}.brand small{font-size:8px;letter-spacing:.8px}.brand strong{font-size:15px}.mark{width:35px;height:35px}.shell,.wide{display:block;padding:28px 20px 50px}.sidebar{display:none}.mobile-nav{display:block;border-bottom:1px solid var(--line);padding:12px 20px;font-size:13px;background:var(--surface)}.mobile-nav summary{cursor:pointer;color:var(--accent);font-weight:650}.mobile-nav nav{display:grid;gap:12px;padding:15px 0}.mobile-nav a[aria-current=page]{font-weight:700}h1{font-size:30px}.hero{padding-top:0}.hero h1{font-size:43px}.lede{font-size:15px}.cards{grid-template-columns:1fr}.command-card{padding:20px}.command-card pre{font-size:11px;padding:13px}.prose{font-size:15px}.prose pre,.source-code pre{padding:14px;font-size:11px}.prose h2{font-size:22px}.prose h3{font-size:18px}footer{display:block;padding:20px}footer span{display:block;margin-top:6px}.source-list a{font-size:11px}}@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}}global.css 的第一行很长，但可以按职责段读，而不是按字符读。:root 提供字体、明暗配色变量和代码背景；后面的 var(--paper)、var(--ink) 等规则都从这里取值。统一变量使暗色媒体查询只需替换色板，不必复制每个组件的选择器。
box-sizing:border-box 让宽度包含 padding 和边框；html 的滚动行为和顶部留白服务于 hash 定位；body 设定背景、文字颜色与行高。链接、选中文本和 :focus-visible 处理交互反馈，其中焦点轮廓让键盘用户能看到当前位置。
header 是 sticky 顶栏，.brand、.mark 和 .top 组成品牌与入口链接；quiet 只是 “NO INDEX” 的视觉标签。.shell 是三列网格：侧栏、正文和页内目录，正文使用 minmax(0,800px) 允许长内容在网格中收缩。.sidebar 与 .toc sticky 并各自滚动，避免长导航把正文推走。
这一段还给导航、标题、首页卡片、提示框、正文、表格和代码块设置基础样式。.prose pre 与 .source-code pre 共享深色背景、可滚动和断词规则，说明“代码可读”依赖页面结构和样式协同，而不需要改变源码文本。
2. 页面组件共享同一视觉协议
仍在同一份全局规则中，.sidebar nav a[aria-current=page] 用强调色和柔和背景表达当前章节；.toc 用更小的文字显示页内目录；.prose>h2 的上边框划分正文段落。首页的 .hero、.actions、.command-card、.cards 和 .notice 只约定如何显示 index.astro 传入的数据，改变卡片文案不会改变构建管线或 runtime。
.source-list 两端对齐文件名和行数，.filename 使用等宽字体并允许断行；footer、.skip 和 .mobile-nav 提供页脚、跳过链接与移动入口。.wide 隐藏右侧目录并扩大正文列，源码等宽内容因此能复用同一布局而不复制一套页面外壳。
3. 主题和断点是层层降级
prefers-color-scheme: dark 只替换 root 色板，并调整按钮前景色对比度，结构与导航关系不变。max-width:1150px 先收起右侧 toc、缩小侧栏并改为两列；max-width:760px 再把 shell 变为块布局、隐藏桌面侧栏、显示移动导航，把卡片变成单列并缩小代码和标题字号。
这条顺序保留了桌面上的主要导航和正文宽度：先移除次要目录，再在更窄时移除桌面侧栏。prefers-reduced-motion:reduce 最后关闭平滑滚动，hash 定位仍然工作，只是不再有动画。
4. 源码行号由 transformer 提供，CSS 负责呈现
site/src/styles/global.css · L2–L8 · 打开完整源码
/* Stable source anchors; numbers are generated content, not copied source text. */
.numbered .line{position:relative;display:inline-block;min-width:100%;padding-left:3.2rem;min-height:1.8em;scroll-margin-top:5.5rem}
.numbered .line-number{position:absolute;left:0;top:0;width:2.3rem;text-align:right;color:#8a9da8;text-decoration:none;user-select:none}
.numbered .line-number::before{content:attr(data-line)}
.numbered .symbol-anchor{scroll-margin-top:5.5rem}
.numbered .line:target,.numbered .line:has(.symbol-anchor:target){background:#143b46;box-shadow:inset 3px 0 #65d8c6}第二行是分隔空行；第三行的注释声明下面的定位规则属于生成内容，不是复制到源码里的文字。.numbered .line 为每个高亮器行节点留出左侧空间，并设置滚动顶部偏移；.line-number 绝对定位、右对齐且不可选择。它读取 transformer 写入的 data-line，所以显示数字来自原始源码行号，而不是从当前 Markdown 重新计数。
.symbol-anchor 复用滚动偏移。:target 负责行号 hash，:has(.symbol-anchor:target) 负责函数 hash；命中后整行改变背景并加左侧高亮。由此形成清晰的责任分工：源码页把锚点放进 DOM，CSS 让目标可见，浏览器负责 hash 跳转。
5. 窄屏函数目录和章节导航有替代入口
site/src/styles/global.css · L9–L15 · 打开完整源码
.function-jump{display:none;border:1px solid var(--line);border-radius:.7rem;margin:1.5rem 0;padding:.9rem 1rem;background:var(--surface)}
.function-jump summary{cursor:pointer;color:var(--accent);font-weight:650}
.function-jump nav{display:grid;gap:.55rem;margin-top:1rem}.function-jump a{display:flex;justify-content:space-between;gap:1rem;text-decoration:none;font-family:monospace}.function-jump small{color:var(--muted)}
@media(max-width:1159px){.function-jump{display:block}}
.toc a,.function-jump a{overflow-wrap:anywhere}.function-jump small{flex-shrink:0}.function-jump 默认隐藏，1159px 以下显示为可展开的函数/声明目录；链接使用等宽字体并保留行号，长 label 可断行。
site/src/styles/global.css · L16–L27 · 打开完整源码
/* Separate prerequisites from implementation instead of one long mixed list. */
.sidebar{max-height:calc(100vh - 6.5rem);overflow-y:auto;padding-right:.4rem}
.nav-section{border-bottom:1px solid var(--line);padding:.3rem 0}
.nav-section>summary{cursor:pointer;color:var(--teal);font-size:.8rem;font-weight:750;padding:.75rem .1rem;line-height:1.45}
.sidebar .nav-section nav{padding-bottom:.7rem}.mobile-nav .nav-section>summary{padding:.8rem .1rem}.mobile-nav .nav-section>a{padding:.55rem .5rem}
.page-steps{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1rem;border-top:1px solid var(--line);padding-top:1.5rem;margin-top:3rem}
.page-steps a{padding:1rem;border:1px solid var(--line);border-radius:10px;text-decoration:none;background:var(--surface)}.page-steps small{display:block;color:var(--muted);margin-bottom:.35rem}.page-steps strong{font-size:.9rem;line-height:1.5;overflow-wrap:anywhere}.page-steps a:hover{border-color:var(--teal)}
@media(max-width:760px){.page-steps{grid-template-columns:1fr}}
.page-jump{display:none;border:1px solid var(--line);border-radius:10px;padding:.8rem 1rem;margin:1.2rem 0}.page-jump summary{cursor:pointer;font-weight:650}.page-jump nav{display:grid;gap:.65rem;margin-top:1rem}.page-jump a{font-size:.9rem;overflow-wrap:anywhere}@media(max-width:1159px){.page-jump{display:block}}
@media(max-width:759px){.top a:not([href="/code/"]){display:none}.top a{white-space:nowrap;flex-shrink:0}.mobile-nav .nav-section{width:100%}.mobile-nav .nav-section a{display:block;padding:.65rem 0;border-bottom:1px solid var(--line)}.mobile-nav .nav-section a:last-child{border-bottom:0}}.nav-section 以边框分隔前置知识与实现，.page-steps 把上一章和下一章变成两列卡片，760px 以下改为单列。.page-jump 是页面标题目录的移动替代入口，1159px 以下显示；它与布局右侧 .toc 读取同一组 headings，但不要求桌面右栏继续存在。最后一个窄屏规则隐藏除源码入口以外的顶栏链接，确保手机上仍能抵达源码索引，并让移动章节链接占满宽度。
这里的 1159px 与全局布局的 1150px 略有差异：页面目录和函数目录会比桌面右栏早一点成为可见的折叠入口。这是两个组件自己的显示条件，不应把它们当成同一个断点。
6. 片段行号使用独立的计数器
code-reading.css 服务于讲义中的源码片段。代码块重置 CSS counter，每个高亮器 .line 递增一次，伪元素显示原始源码行号；因此片段从 L21 开始时，第一行不会重新显示为 1。
行号伪元素有固定宽度、右对齐和 user-select:none，所以读者能复制代码而不把显示数字当成源码。.reading-start 给提示起点加左边框；窄屏媒体查询缩小字体和行号区，但不改变起点或源码内容。
这条计数器链与源码完整页面的 transformer 链不同：前者通过 CSS counter 给 Markdown 片段编号，后者通过 Astro Code transformer 写入 DOM id。两者都依赖提取器传来的原始行号，最后都能跳回真实源码页。完整的样式源码块见 页面外壳。
7. 从 HTML 到视觉结果的检查点
可以把浏览器阶段压缩成四步：页面组件先输出结构和 class；全局 CSS 建立颜色、网格和文字规则；媒体条件覆盖不适合当前视口的值；hash 目标通过行号或 symbol 选择器高亮。CSS 既不会生成导航数据，也不会替代 verify.mjs 对锚点和源码文本的验证。
读完本章，应能回答：为什么源码行号不会被复制进代码？桌面目录怎样逐级降级到手机折叠入口？为什么片段和完整源码页各有一条编号机制？页面结构与布局的来源见 页面外壳，定位节点的生成见 源码页面。