AI 写的前端代码为什么总像 5 年前的?Chrome 官方出手了
来源:Chrome for Developers · Modern Web Guidance(根据官方文档整理)
你让 AI 写个弹窗,它给你手搓了一堆 JS 控制显示隐藏、手动管理焦点、再配一个 z-index 大战。你让它做个提示气泡,它第一反应是引入一个第三方库。
功能能跑,但写法停留在好几年前。浏览器明明早就原生支持 <dialog>、Popover API 了,AI 却像没听说过一样。
一个常见的原因是:AI 学到的代码里,老写法数量远多于新写法,而且它并不清楚某个新特性在各大浏览器里到底能不能放心用。
Chrome 团队最近推出的 Modern Web Guidance,就是冲着这个问题来的。
它是什么
Modern Web Guidance 是一组 skill(技能) ,可以把 Web 平台的专业知识、最佳实践和浏览器兼容性数据,直接嵌入到 AI 编码智能体里。
说白了,它不是新框架,也不是新工具链,而是给你的 AI 助手补了一份“现代 Web 知识库”,让它在写代码时优先参考官方推荐的现代做法。
里面装了多少东西
按官方 README 的数据,这套技能目前收录了 250 个现代 Web 特性和 203 个真实开发用例。特性按三大类归档:
| 特性类别 | 数量 | 代表特性 |
|---|---|---|
| CSS 与布局 | 140 | 容器查询、Subgrid、oklch() 颜色、View Transitions、@starting-style、Anchor Positioning |
| HTML 与 DOM | 36 | Popover、、声明式 Shadow DOM、Invoker Commands |
| JavaScript 与 API | 74 | scheduler.yield()、fetchLater()、Speculation Rules、Temporal |
用例侧覆盖六大核心方向:用户体验(进出动画、滚动驱动效果)、CSS 布局、性能(INP 诊断、长任务拆分)、表单与 UI(原生校验、输入时机)、无障碍(键盘可操作性、读屏适配)、内置 AI(本地翻译、摘要 API)。
另一个值得注意的细节:这些指南不是把文档整包塞给模型。项目用评测(evals)主动剪掉了"模型本来就会写"的内容,只保留模型不知道、或最容易用错的部分——所以它对上下文窗口的消耗是有节制的。

它是怎么工作的
整个流程分三步。第一步,编码 Agent 接到 Web 相关任务时自动激活这个技能;第二步,Agent 调用 search 命令做本地语义检索——用的是离线的 embedding 模型加 BM25 引擎,不需要联网,也没有 API key;第三步,用 retrieve 按 ID 把命中的指南(代码模式、兼容性提醒、回退方案)直接读进上下文,然后才动手写代码。
兼容性数据来自 Baseline——由 Chrome、Edge、Firefox 和 MDN 团队共同维护的浏览器特性支持标准。它把特性支持度分成三档:
- Limited availability:各大浏览器还没对齐,别急着用;
- Newly available:跨浏览器可用,但还不到 30 个月;
- Widely available:跨浏览器可用超过 30 个月,可以放心用。
项目的默认目标就是 Widely available。如果你的项目要兼容更老的浏览器,需要在 AGENTS.md 或 CLAUDE.md 里显式写明目标;至于 Origin Trial 和近 3 个月刚上线的实验性特性,默认是锁住的,要用得改 .mwgrc 配置显式解锁。

怎么装
官方推荐使用 CLI 一键安装:
npx modern-web-guidance@latest install
如果你用的是具体某个工具,也可以按下面的方式装:
Claude Code
claude plugin install modern-web-guidance@claude-plugins-official
通用方式(Vercel Agent Skills)
npx skills add GoogleChrome/modern-web-guidance
另外,Copilot CLI 和 Antigravity CLI 也有对应的安装方式,具体命令在官方文档的安装页里可以查到。
它能帮你做什么
官方给了四类示例提示,基本代表了它的使用场景。
1. 打造全新体验
- 做一个带平滑展开 / 收起动画的手风琴组件
- 用 CSS Anchor Positioning 做一个滑动高亮跟随当前项的标签栏
- 用容器查询(Container Queries)让仪表盘卡片根据自身宽度调整布局
2. 旧代码现代化
- 把老式弹窗改成
<dialog>元素,并用现代 CSS 加动画 - 把旧的 tooltip 迁移到 Popover API,配合 CSS Anchor Positioning
3. 提高安全性
- 基于 WebAuthn 实现 Passkey 登录流程
- 在不破坏现有功能的前提下,加上一份起步版 CSP(内容安全策略)
- 对站点做一次安全审计并给出改进建议
4. 提升性能
- 用户悬停在重要链接上时,提前预加载页面
- 排查长任务(Long Tasks),改善 INP
- 优化 LCP
一个真实的对比:手搓版 vs 原生版
国外有开发者做过一组对比实验:用同一个提示词,分别跑"装了技能"和"没装技能"的 Gemini CLI,做同一个任务管理应用。差异很直观:
| 场景 | 没装技能 | 装了技能 |
|---|---|---|
| 模态框 | 手写 portal 和状态管理,配一个 300ms 的 setTimeout 硬凑动画时机 | 原生 ,进出动画全交给 CSS |
| 任务卡片布局 | 媒体查询 | 容器查询(Container Queries) |
| 2000 条数据搜索 | useMemo 同步过滤,主线程卡顿 | scheduler.yield() 分块处理,不卡主线程 |
| 帮助气泡 | 引入 Floating UI 依赖 | CSS Anchor Positioning + popover=“hint”,零 JS |
拿弹窗举例。AI 手搓的版本,核心逻辑大概长这样:
<!-- 手搓版:JS 管状态、管焦点、管时序 -->
<div class="backdrop" id="backdrop" hidden>
<div class="modal">
<h2>确认删除</h2>
<button id="ok">确定</button>
<button id="cancel">取消</button>
</div>
</div>
<script>
const bd = document.getElementById("backdrop");
let lastFocus = null;
function openModal() {
lastFocus = document.activeElement;
bd.hidden = false;
document.addEventListener("keydown", escClose); // Esc 关闭要自己监听
ok.focus(); // 焦点圈定要自己做
}
function closeModal() {
setTimeout(() => { bd.hidden = true; }, 300); // 等动画播完再隐藏
document.removeEventListener("keydown", escClose);
lastFocus.focus(); // 焦点回归也要自己做
}
</script>
而换成原生的 元素,核心代码只有这么几行:
<!-- dialog 版:浏览器把杂活全包了 -->
<dialog id="dlg" class="modal">
<h2>确认删除</h2>
<button id="ok">确定</button>
<button onclick="dlg.close()">取消</button>
</dialog>
<script>
dlg.showModal(); // 自动进顶层、圈定焦点、Esc 关闭
dlg.close(); // 关闭后焦点自动回归
</script>
<style>
dialog {
opacity: 0;
transition: opacity .3s, display .3s allow-discrete, overlay .3s allow-discrete;
}
dialog[open] { opacity: 1; }
@starting-style { dialog[open] { opacity: 0; } } /* 打开动画 */
</style>

当然,这只是单次演示,不能当成严格的基准测试。原生方案也不总是全胜——Anchor Positioning 在老浏览器上需要回退方案,原生 dialog 也还是要人工验证键盘导航和读屏体验。
配套资源
- 官方 Codelab 入门教程:拿一个旧版 Web 应用练手,学习怎么设置 Baseline 浏览器目标、优化 Core Web Vitals,把“通用的 AI 输出”变成更现代、性能更好的方案。
- 搭配“面向智能体的 Chrome 开发者工具” :可以让 AI 跑实时性能审核、检查无障碍树、抓取控制台日志,然后自动套用对应的现代 Web 修复。
- 开源:项目在 GitHub 上(GoogleChrome/modern-web-guidance-src),欢迎提交 issue 和贡献内容。
- 官方还有一个概览视频,讲这个项目解决什么问题、怎么改进 AI 辅助的 Web 开发流程。
不装进 Agent 也能用
就算暂时不想把它接进编码工具,CLI 本身也能当独立的"现代写法查询器":
# 按问题搜索指南
npx modern-web-guidance@latest search "animate a dialog modal backdrop"
# 按搜索结果返回的 ID 读取完整指南
npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"
# 扫描现有代码库里的旧式写法
npx modern-web-guidance@latest legacy-scan .
search 按问题搜指南,retrieve 按 ID 读全文,legacy-scan 则可以扫一遍现有代码库,把"能用原生特性替代的旧写法"列出来——拿它给存量项目做一次现代化体检,比拍脑袋列技术债清单靠谱。
装之前要知道的事
- 项目目前仍标记为 Preview,指南内容还在持续扩充,别指望它覆盖所有浏览器边界情况;
- 它给的是建议不是强制约束,也替代不了真实浏览器测试——Agent 读了正确的指南,照样可能把 API 用错;
- CLI 会收集匿名的安装量、Agent 名称和检索词(不包含原始提示词),介意的话设置环境变量 DISABLE_TELEMETRY=1;
- 代码是 Apache-2.0 协议,guides 目录下的指南内容是 CC-BY-4.0,二改指南对外发布时注意署名要求。

小结
Modern Web Guidance 的思路很简单:与其每次手动提醒 AI“请用 dialog 别手搓弹窗”,不如一次性把现代 Web 的最佳实践装进去。
如果你本来就在用 Claude Code 之类的工具写前端,装它的成本只有一行命令,值得试一试。
官网:developer.chrome.com/docs/modern-web-guidance
GitHub:GoogleChrome/modern-web-guidance-src
更多推荐



所有评论(0)