15 · Webview 实时预览
Builder 模式的杀手级体验——代码写出来就立刻能看到跑起来的样子。
01 Webview 是什么
Webview 是 Builder 模式的右侧预览面板。当 AI 在 Builder 模式下生成和修改代码时,右侧的 Webview 窗口会实时渲染你的应用——就像浏览器开发者工具里的设备模拟器,但完全嵌在 IDE 里。
你可以点击页面上的按钮、输入表单、导航页面——它是真实运行的,不是静态截图。这让你在 AI 写代码的同时就能看到效果,不切换窗口、不手动刷新。
02 Webview 的工作方式
Builder 生成/修改代码
↓
文件自动保存
↓
dev server 热重载(HMR)
↓
Webview 自动刷新显示最新效果
↓
你在 Webview 里交互、发现要调整的地方
↓
在 Builder 输入框描述修改 → 循环支持的前端框架
| 框架 | 支持情况 | 备注 |
|---|---|---|
| React / Next.js | ✅ 最佳 | HMR 最快 |
| Vue / Nuxt | ✅ | 需要配置 dev server |
| Vite 项目 | ✅ | 开箱即用 |
| HTML/CSS/JS | ✅ | 无需构建工具 |
| Svelte / SvelteKit | ✅ | |
| Angular | ⚠️ | HMR 可能较慢 |
03 Webview 的交互能力
Webview 不只是”显示”,它还能交互:
| 操作 | 怎么做 |
|---|---|
| 点击链接/按钮 | 直接在 Webview 里点 |
| 填写表单 | 直接在 Webview 里输入 |
| 调整窗口大小 | 拖拽 Webview 边缘 |
| 切换设备视图 | 选择手机/平板/桌面尺寸 |
| 打开浏览器 DevTools | Webview 工具栏 → DevTools 图标 |
| 在新浏览器中打开 | 复制 URL → 粘贴到浏览器 |
| 截图 | Webview 工具栏 → 截图按钮 |
设备模拟
Webview 内置了常见设备尺寸:
- iPhone SE / iPhone 14 Pro
- iPad / iPad Pro
- MacBook / Desktop
选择对应设备后,Webview 按该设备的视口渲染,方便做响应式检查。
04 Webview + 多模态:设计稿驱动的开发
Webview 和 Builder 的多模态输入结合,产生了一个高效的开发模式:
你拖入 Figma 设计稿截图
↓
Builder 根据截图生成代码
↓
Webview 实时显示效果
↓
你对比设计稿 vs 实际效果
↓
在 Builder 中描述差异:"按钮圆角再大一点"、"这个颜色往深调"
↓
AI 修改 → Webview 刷新 → 再对比
↓
直到和设计稿一致这种工作流让设计到代码的转化从”设计师截图 → 开发看着截图手写代码”变成了”截图拖进去 → AI 写 → 你微调”。
05 Webview 的调试能力
内置 DevTools
Webview 工具栏有 DevTools 按钮,点击打开类似 Chrome DevTools 的面板:
- Console:查看 console.log 输出和错误
- Elements:检查 DOM 结构和 CSS
- Network:查看网络请求
- Application:查看 localStorage / sessionStorage
错误反馈
当 Builder 的代码有运行时错误时,Webview 会在预览区显示红色错误提示。你可以把错误信息直接”添加到对话”——点错误弹窗的按钮,错误信息和堆栈追踪会自动粘贴到 Builder 输入框,让 AI 针对性地修复。
06 Webview 的局限性
| 限制 | 说明 | 解决方案 |
|---|---|---|
| 后端 API 调用 | 如果前端调的是 localhost:3000/api 但后端没启动,请求会失败 | 同时启动后端,或在 Builder 中让 AI 创建 mock 数据 |
| 数据库连接 | Webview 只是前端渲染,数据库操作需要后端 | Builder 模式下 AI 可以同时启动后端 |
| 第三方登录(OAuth) | Webview 环境可能没有 OAuth 回调配置 | 在新浏览器中打开测试 |
| 复杂路由 | 某些框架的路由在 Webview 中可能不正常 | 在新浏览器中验证 |
| 性能 | Webview 比原生浏览器稍慢 | 性能测试用原生浏览器 |
07 小结
| 要点 | 说明 |
|---|---|
| Webview 是什么 | Builder 模式下的实时应用预览面板 |
| 能交互吗 | 可以——点击、输入、导航,跟浏览器一样 |
| 什么时候用 | Builder 模式自动启用,也可以手动打开 |
| 调试方式 | 内置 DevTools,查看 Console/Elements/Network |
| 核心优势 | 写代码 → 看效果 → 改代码的循环不用切窗口 |
下一篇:16 Git 工作流 —— Trae + Git:AI 帮你管理版本,但 push 的钥匙永远在你手里。