做前端 Vibe Coding,先看懂这 12 个网页基础术语
做前端 Vibe Coding,先看懂这 12 个网页基础术语
做前端 Vibe Coding 时,没有计算机背景的人最常卡在表达上:心里知道想要什么效果,却叫不出对应的网页部位名称,导致 AI 反复改错地方。
本文整理了 12 个前端网页基础术语,涵盖界面结构、样式布局、运行状态与页面元数据,每个术语都附有图解和可直接发给 Agent 的检查指令。
01|Frontend(前端):用户直接接触的那一层
Frontend(前端)指用户在网页、小程序或桌面软件里能直接看到、点击和输入的那一层界面。
登录页里的标题、输入框、登录按钮、加载提示、成功提示和报错信息,都属于前端。
前端显示“登录成功”,不代表账号真的通过了校验。密码是否正确、用户有没有权限、数据是否落库,要看后端返回的真实结果。
当 Agent 回复“前端已完成”时,你可以追问一句:页面只是渲染出来了,还是点击、提交、成功和失败状态都验证过了?
Frontend 架构与前后端连接示意图
图解说明:图中浏览器内的内容展示、输入点击、过程反馈和结果状态都属于前端。右侧后端负责校验、权限和存储,前后端通过请求与返回结果通信。
你可以直接复制给 Agent 的指令:
| 1 | 检查这个登录页面的前端流程:输入、点击、加载、成功和失败状态都要真实可见,不要只确认页面已经显示。 |
02|HTML:网页里有什么内容,以及它们是什么
HTML 负责定义网页的内容结构与语义。你在网页源码里看到的 < > 尖括号英文标签就是 HTML,浏览器读取这些标签来渲染页面结构。
标题、段落、图片、链接、表单、按钮和输入框都由 HTML 声明,用来告诉浏览器页面里有哪些元素,以及它们之间的层级关系。
比如文章标题用标题标签,跳转页面用链接标签,提交表单用按钮标签。虽然 CSS 可以把它们画成相似的外观,但它们在键盘操作、无障碍朗读、搜索引擎识别和默认行为上完全不同。
HTML 只描述内容结构与含义,不控制颜色、间距等视觉样式,也不处理点击后的业务逻辑。视觉样式和交互逻辑分别交给 CSS 与 JavaScript。
如果页面漏了一段文字、标题层级乱了,或者按钮放错了区域,应该先检查 HTML,不要只改 CSS。
你可以这样和 Agent 沟通:
| 1 | 检查这篇文章的 HTML 结构:页面主标题是否使用正确的标题元素,查看原文使用真实链接,提交操作使用按钮,并保留现有视觉样式。 |
03|CSS:网页的外观与响应式布局
CSS 控制网页的视觉外观、排版布局,以及页面在不同屏幕宽度下的响应式变化。
颜色、字体、字号、间距、圆角、阴影、对齐方式,以及桌面端三列、手机端单列的排布,都由 CSS 决定。
有时一个按钮在 HTML 里已经存在,也能正常点击,但颜色却是灰的,或者在手机屏幕上超出了边界。这类问题通常是因为某条 CSS 规则覆盖了原有的颜色或尺寸,跟按钮本身是否缺失无关。
CSS 里的 C 代表层叠(Cascading)。同一个元素可能同时命中多条样式规则,浏览器会按选择器范围、优先级和先后顺序算出最终样式。
CSS 样式层叠与视觉表现示意图
图解说明:左侧 HTML 用标签确定标题、正文和按钮;右侧 CSS 在保留原有内容结构的前提下,调整颜色、间距和视觉层级。
遇到样式不对时,不要让 Agent 重写点击逻辑,先让它查清哪条样式规则生效、哪条规则被覆盖。
你可以直接复制给 Agent:
| 1 | 这个主按钮可以点击,但颜色仍然是灰色。请检查它匹配到的 CSS 规则和最终计算样式,找到覆盖主题色的声明,不要改 HTML 结构和点击行为。 |
04|Markdown:用简单符号写出结构化文本
Markdown 是一种轻量标记语言,本质上是带结构符号的纯文本格式。
你在 AI 对话框、项目 README 或笔记软件里常见的 #、-、** 和三个反引号,就是 Markdown 语法。
它用少量符号标记标题、列表、粗体、链接和代码块。源文件本身仍是纯文本,经过支持 Markdown 的工具渲染后,才会变成排版清晰的阅读视图。
同一段 Markdown 贴进不同软件,显示效果可能不同。有的编辑器支持表格、任务列表和脚注,有的只识别基础标题和列表,还有的不做渲染、直接显示原始符号。
Markdown 适合写文档和维护文字结构。如果要精确控制网页视觉设计,还是要用 HTML、CSS 和 JavaScript。
Markdown 纯文本源码与渲染后视图对比
图解说明:左侧的
#、-、**和反引号仍是纯文本符号;经过渲染后,才会变成右侧带标题、列表、重点和代码块的页面。
你可以直接复制给 Agent:
| 1 | 把这份说明整理成 Markdown:标题表达层级,步骤使用列表,命令放进代码块。完成后检查渲染效果和所有代码块是否正确闭合。 |
05|Component(组件):可重复使用的界面单元
Component(组件)把一块界面和它对应的交互行为封装在一起,方便在不同页面重复调用。修改组件母版后,所有引用它的地方都会同步更新。
比如首页、搜索页和收藏页都要展示商品卡片,每张卡片都包含图片、商品名、价格和收藏按钮,这一整块就适合抽成一个商品卡片组件。
后续如果要把价格显示从“899 元”改成“¥899”,只需改这一个组件,三个页面就会一起更新。
组件通常只封装职责独立、重复出现且需要统一维护的界面模块,不需要把整个页面或每一行零散文字都单独拆成组件。
Component 组件母版与复用实例关系图
图解说明:图中只有一个组件母版,渲染出了三张结构一致的商品卡片。后续修改按钮样式或价格格式时,直接修改母版即可同步生效,无需分别改动三个页面。
你可以直接复制给 Agent:
| 1 | 首页、搜索页和收藏页使用的是同一种商品卡片。请把它整理成一个可复用的 Component,同时保留每个页面传入不同商品数据的能力。 |
06|State(状态):界面当前记住的数据变化
State(状态)是界面当前需要记住、并随用户操作或接口返回而变化的数据。
一个提交按钮刚打开时可以点击,这是默认状态;点击后变成“正在保存”,这是加载状态;接口返回成功后显示“已保存”,失败后显示报错与重试入口,这些都是不同的 State。
弹窗当前是打开还是关闭、购物车里有几件商品、当前选中了哪个筛选条件,也都属于状态。
前端状态不等同于后端数据库。 页面上的 State 变成“保存成功”,不代表服务器真的写入了数据。如果刷新页面后内容消失,说明代码只改了前端临时状态,没有做持久化存储。
State 状态机与不同操作生命周期流转图
图解说明:同一个提交控件会依次处于默认、保存中、成功和失败状态。状态切换应以真实接口返回结果为准,不能刚点击就提前显示成功。
你可以这样和 Agent 说:
| 1 | 检查保存流程的 State:点击后先进入正在保存,成功后再显示已保存,失败时显示错误和重试入口,并阻止用户重复提交。 |
07|DOM:浏览器运行时的页面节点树
DOM 全称 Document Object Model(文档对象模型)。浏览器读取 HTML 后,会把标题、段落、按钮和列表组织成一棵可由程序读写的节点树,这棵树就是 DOM。
运行时的 DOM 和最初写在源码文件里的 HTML 未必一致。
例如 HTML 源文件里只有一条任务,用户点击“添加”按钮后,JavaScript 向 DOM 插入了第二条任务。这时页面上能看到新任务,但原始 HTML 文件里并没有这行代码。
DOM 变化只代表当前内存里的页面变了。刷新浏览器后新内容还在不在,取决于数据有没有写入浏览器本地存储(LocalStorage / IndexedDB)或后端数据库。
DOM 树与运行时新增节点示意图
图解说明:左侧是初始 HTML 文件,右侧是浏览器运行时的 DOM。橙色 LI 是 JavaScript 动态插入的新节点;它能立即显示在页面上,但刷新后是否保留取决于数据有没有另外存储。
你可以直接复制给 Agent:
| 1 | 点击添加后页面出现了新任务,但源 HTML 里没有。请检查运行时 DOM 新增了什么节点,并继续确认数据是否真的保存,刷新后是否仍然存在。 |
08|Title Tag:浏览器标签页里的页面标题
Title Tag 是写在 HTML 文档头部(<head>)里的页面标题标签。
它最直接的作用是在浏览器顶部标签页上显示当前页面名称。搜索引擎也会参考它生成搜索结果标题,有时会根据搜索词做改写。
Title Tag 和页面正文里的大标题 <h1> 是两个独立的元素。
比如商品详情页的正文 H1 可以简写为“按摩座椅”,而 Title Tag 可以写成“按摩座椅|西昊 300”,方便用户在打开十几个标签页时一眼分清商品与站点。
如果所有商品页的 Title Tag 都写死成“商品详情”,哪怕正文里的 H1 各不相同,用户切换浏览器标签页时也分不清哪个是哪个。
Title Tag 与 H1 差异对比图
图解说明:浏览器顶部的标签页文字来自 Title Tag,正文里的“按摩座椅”来自 H1。两者内容可以相关,但代码位置不同,需要分别配置与核对。
你可以直接复制给 Agent:
| 1 | 给每个商品详情页设置独立的 Title Tag,包含对应商品名,同时保留页面里的 H1。切换两个商品页,确认浏览器标签标题会跟着变化。 |
09|Page Metadata:写给页面外部读取者的信息
Page Metadata(页面元数据)通常放在 HTML 文档头部,不直接渲染在页面正文里,专门供浏览器、搜索引擎、社交平台或应用安装入口读取。
浏览器标签页读取页面标题,搜索引擎参考页面描述(Description),社交软件抓取分享卡片信息,桌面安装入口读取 Manifest 配置。
这些配置统称为 Page Metadata,需要按读取方逐项核对,不存在一个一键全通的总开关。
浏览器标签页显示正常,不代表微信或 X 的分享卡片一定有图;分享卡片正常,也不代表网页安装到桌面后的名称和启动路径正确。 排查问题时,先确认这条信息是给哪个外部系统读取的。
Page Metadata 多读取方与各司其职示意图
图解说明:同一个网页会向不同读取方提供不同元数据:Favicon 显示在浏览器标签页,Open Graph 生成分享卡片,Manifest 决定安装后的图标和启动方式。这几项不能互相替代。
你可以直接复制给 Agent:
| 1 | 分别检查这个页面提供给浏览器标签、搜索摘要、链接分享和安装入口的 Page Metadata。列出每个读取方使用的字段,并验证各自的真实结果。 |
10|Favicon:标签页与书签栏的站点小图标
Favicon 是浏览器用来标识站点身份的小图标,显示在标签页、书签栏和历史记录里。用户同时打开几十个标签页时,主要靠这个小图标快速找回你的网站。
Favicon、网页顶栏的品牌 Logo 和按钮旁的功能图标(Icon)分属三处不同的资源配置。
它们可以共用同一套品牌图形,但替换网页顶栏的 Logo 并不会自动更新浏览器标签页上的 Favicon。
更新 Favicon 后如果浏览器仍显示旧图标,很可能是本地缓存尚未过期。排查时需要同时核对图标文件本身、HTML <link> 引用路径,以及无痕窗口或清缓存后的实际显示结果。
你可以直接复制给 Agent:
| 1 | 替换网站的 Favicon,但不要改网页头部 Logo 和功能图标。检查页面引用的图标资源,并在标签页、书签和浏览历史里验证;如果仍是旧图,请说明缓存证据。 |
11|Open Graph:链接分享出去时的预览卡片
Open Graph(简称 OG)是一组定义链接分享预览卡片的元数据协议。
当你把网页链接发到聊天软件或社交平台时,预览卡片上的标题、摘要、封面图和跳转地址,主要读取页面头部的 og:title、og:description、og:image 和 og:url 标签。
网页正文里能正常显示封面图,不代表社交平台抓取分享卡片时也能拿到这张图。
Open Graph 的图片地址必须填写外部服务器能直接访问的完整公网 URL(以 https:// 开头)。 如果填了本地路径、需要登录鉴权的地址,或者写了相对路径,分享卡片就会丢图。
社交平台还会缓存历史抓取结果。修改代码后只看网页源码还不够,需要用各平台的卡片校验工具或真实转发来测试预览效果。
你可以直接复制给 Agent:
| 1 | 为这篇文章补齐 Open Graph 的标题、描述、绝对图片地址和规范网址。不要把正文封面正常显示当成完成,请用真实的外部分享预览验证结果。 |
12|Web App Manifest:网页安装后的身份和启动方式
Web App Manifest 通常是一个 .json 配置文件,用来定义网页添加到手机主屏或桌面后的应用名称、图标和启动方式。
常见字段包括 name、icons、start_url 和 display。浏览器读取这些字段后,决定安装入口显示什么名字、用哪张图标、点开后进入哪个路径,以及用普通浏览器标签还是独立应用窗口打开。
Manifest 里的图标和 Favicon 各管各的:Favicon 用于浏览器标签页和书签,Manifest 图标用于安装后的桌面应用入口,需要在两处分别配置。
配置了 Manifest 只代表网页支持安装入口,不代表它已经是支持离线访问的完整 PWA。 离线缓存还需要额外编写 Service Worker 脚本。
你可以直接复制给 Agent:
| 1 | 检查页面引用的 Web App Manifest,确认 name、icons、start_url 和 display。修改后删除旧安装并重新安装,再验证名称、图标、启动地址和窗口模式,不要把可安装等同于支持离线。 |
12 个术语速查与沟通方法
看到 Agent 的回复时,你可以先按这份速查清单判断它在改哪一层:
- 整个用户可见与可交互界面:
Frontend - 网页的内容结构与语义标签:
HTML - 网页的视觉样式与响应式布局:
CSS - 用符号标记标题、列表和代码块的纯文本:
Markdown - 跨页面重复调用的界面单元:
Component - 界面当前记录的动态数据与状态:
State - 浏览器运行时的页面节点树:
DOM - 浏览器标签页标题:
Title Tag - 供浏览器、搜索引擎、分享平台读取的头部信息:
Page Metadata - 标签页与书签栏的站点小图标:
Favicon - 链接转发时的社交预览卡片:
Open Graph - 网页安装到桌面后的名称、图标与启动配置:
Web App Manifest
你不需要死记硬背这些定义。下次遇到 Agent 提到陌生术语时,先核对两个问题:
- 它负责页面或系统的哪个位置?
- 改完之后我应该在哪里看到什么具体变化?
把这两个问题讲清楚,你发给 Agent 的提示词就能从模糊的“帮我看看哪里不对”,变成可定位、可验证的具体指令。
觉得本文有启发?一键复制标准引用摘要
自带原文归因链接与核心摘要,可直接粘贴至团队飞书/Slack 知识库、技术周报或大模型上下文。