screenshot-to-code:把截图和设计稿转成前端代码

screenshot-to-code 是开发者 abi 用 Python 加 React 写的开源项目,GitHub 上 81,292 星、MIT 许可、11 月 15 日还有提交,把界面截图、设计稿或一段操作录屏丢进去,由视觉模型输出能直接打开的 HTML+Tailwind、React、Vue 或 Bootstrap 页面;程序免费,但要自备至少一个模型厂商的 API Key,生成费用按各家 token 价算。

前端最烦的活不是写逻辑,是把设计稿一格一格对出来:间距差 4 像素、圆角不对、图标要重新切。老系统改版更麻烦,源文件早就丢了,只剩几张截图。这个工具把「看图写页面」这一步交给模型,人只负责调细节,做原型和复刻旧页面的速度能差出好几倍。

参数一览

项目名称 screenshot-to-code
作者 / 技术栈 abi / FastAPI 后端 + React、Vite 前端
Star / 许可 81,292 星 / MIT
输出栈 HTML+Tailwind、HTML+CSS、React+Tailwind、Vue+Tailwind、Bootstrap、Ionic+Tailwind
默认模型 Gemini 3 Flash / 3.1 Pro、GPT-5.5、Claude Opus 4.6 与 4.8
输入形式 截图、设计稿图片、网页操作录屏
费用 软件免费;模型调用按厂商价格自付

能做什么

  • 截图转页面:给一张网页或 App 界面图,输出结构完整的单页代码,样式用 Tailwind 或普通 CSS。
  • 录屏转原型:录一段网页上的操作,它按帧理解交互,生成带跳转和状态变化的可点原型。
  • 复用图里的素材:配 Gemini 时会把截图里的 logo、插画抠出来当真实图片用,而不是画一堆占位方块。
  • 多模型对比:配了多家 Key 之后,同一个截图可以一次生成多个版本,挑选还原度最高的那个。
  • 配套的图片处理:接上 Replicate 后能做背景移除和图片编辑,生成的页面不至于缺图。

适合人群

  • 要在几小时内交出可点原型的产品经理和独立开发者。
  • 手里只有截图、需要复刻旧页面的维护者。
  • 学前端的人,拿它生成的代码对照自己的写法。
  • 反例:要求像素级还原、要接进生产项目的,模型输出只能当初稿,响应式和交互逻辑仍要人来补。

上手步骤

  1. 克隆仓库,后端进 backend 目录,用 Poetry 装依赖,再用 playwright 装上 Chromium,供截图预览使用。
  2. 在 backend 下建 .env,至少填 OpenAI、Anthropic、Gemini 三者之一;想用图片处理和素材提取就把 Gemini 与 Replicate 的 Key 也加上。
  3. 启动后端,默认跑在 7001 端口;再进 frontend 目录,用 pnpm 装依赖并启动开发服务器。
  4. 浏览器打开 5173 端口,把截图拖进左侧输入区,选目标技术栈,点生成。
  5. 生成的页面可以在右侧直接预览,不满意就换模型重跑,或者把代码复制到本地继续改。装了 Docker 的话,仓库也提供一条命令起全套。

问:不花钱能用吗?

答:软件本身免费,但生成必须调用模型,至少得有一个厂商的 Key,按 token 付费。作者另有一个托管版,不想折腾环境可以直接用,按次收费。

问:生成的代码能直接上线吗?

答:能跑,但别直接上线。间距、响应式断点、表单校验、无障碍属性通常要人工补一遍,把它当高质量的初稿最合适。

问:中文界面截图支持吗?

答:支持,模型识别的是布局和文字内容,中文文案基本能还原,字体要换成自己项目里的字体栈。

问:能直接读 Figma 文件吗?

答:不能直连,Figma 设计稿要以图片形式输入。想省这一步,可以在 Figma 里导出整页截图再喂进去。

最后更新:2026-11-19

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。