静态网站生成器
为 AI 网站开发而生
把页面写成纯文本文件,或者让你的 AI 编程助手来写:Claude Code、Cursor、Codex、Copilot 或 Gemini CLI 都可以。vagejs 是一款免费、开源的静态网站生成器,它把这些文件变成一个快速、安全、搜索引擎和 AI 助手都能读懂的网站。
npm create vagejs@latest my-site复制这条命令 · 需要 Node.js 22.12 或更高版本
MIT 许可证 · v0.16.2 · 在 GitHub 上开源 · Lighthouse 报告
开始使用配合 Claude Code 使用让你的 AI 助手搭建网站
- 开箱即得 Lighthouse 100 分
- 内置 SEO 和 AI 搜索所需文件
- 支持 React、Vue 和 MDX,默认不带 JavaScript
- 支持多语言网站
- $ npm create vagejs@latest my-site
- Created ~/projects/my-site
- Install and start the site now? (Y/n) y
- added 80 packages in 9s
- Build your site with: 1. Claude Code 2. Codex 3. The browser editor 4. Just open the site
- Choose a number (Enter for 1): 1
- vagejs dev server running at http://localhost:5173/
- same server: http://[::1]:5173/
- editor: http://[::1]:5174/ (edit pages in your browser; only on this computer)
- Starting Claude Code in my-site.
不是开发者?
用 AI 助手搭建你的网站。
你提需求,AI 助手来搭建。
每个页面上线前,vagejs 都会检查一遍。
创建网站时,选好你的助手,它会从第一条提示词开始,和你一起把网站搭起来。每个新网站都自带一个说明文件 AGENTS.md,告诉助手有哪些命令、要遵守哪些规则。所以它会按正确的方式写页面,修好检查发现的问题,并且在发布任何内容之前先问你。
- 你的提示添加一个价格页面
- AI 助手遵循 AGENTS.md
- 页面文件src/pages/pricing.md
- vage check链接、标题、无障碍
- 由你批准先看计划
- 网站上线能访问才算完成
-
你提需求
用你自己的话,描述你想要的页面。
-
它来写页面
页面就是一个纯文本文件,你自己也能看懂、能修改。
-
vagejs 来检查
检查会指出具体是哪个文件、什么问题,助手会在你看到之前就把它修好。
-
你批准部署
你会先看到部署计划。只有你同意,网站才会上线;只有网站能正常访问,它才会说完成。
在浏览器里编辑。
边打字边看页面效果。
npm run dev 还会启动一个本地编辑器:里面有新网站的后续步骤、所有页面、填写页面信息的表单、按你网站设计实时预览的正文、图片上传和检查结果。它编辑的就是你的 AI 助手所编辑的那些文件,而且永远不会成为线上网站的一部分。

用 vagejs 搭建的真实网站。
静态网站示例,附带可直接复制的源码。
查看案例
内容网站需要的,这里都有。
内置 SEO、网站地图和 llms.txt。
-
写作
页面是文本文件或 MDX。布局可用 TypeScript、React 或 Vue 编写。
文件即页面
把一个文本文件放进文件夹,它就是一个页面。可以按主题给页面打标签、把草稿隐藏起来,或者给文章设定日期,到时再发布。
用法:src/pages/pricing.md → /pricing/在浏览器里编辑
每个页面一张表单,按你的设计实时预览,还有新网站的后续步骤,全部在你自己的电脑上。也可以直接编辑文件。
用法:npm run devReact、Vue 和 MDX
用组件写布局,用 MDX 写页面。它们都会变成纯 HTML,只有你标记为可交互的组件才会在浏览器里运行。
用法:<Counter client:load />更小的图片
照片会生成调整过尺寸的 WebP 和 AVIF 副本,每个浏览器按需选择合适的尺寸。
用法:images: { optimize: true }
-
被找到
搜索引擎和 AI 助手能准确了解每一个页面。
网站地图、robots.txt 和 llms.txt
根据真实存在的页面生成,另外还有 RSS 订阅源,以及供 AI 工具读取的页面 Markdown 副本。
用法:npm run build搜索和社交分享预览
页面摘要、每个页面的分享图片、面包屑导航和结构化数据,帮助 Google 和 AI 助手理解每个页面。
用法:defaultImage: "/images/og.png"多语言网站
每种语言一个文件夹,每个页面都有正确的语言标签,还会检查哪些翻译还缺着。
用法:i18n: { locales: ["fr"] }AI 爬虫由你决定
可以分别允许或阻止 AI 训练爬虫和 AI 搜索爬虫。
用法:robots: { aiTraining: "disallow" }
-
检查与防护
问题在你自己的电脑上就会暴露,不会等到访客看到。
-
发布与增长
一条命令上线,然后看看大家是怎么找到你的。
一条命令发布
Cloudflare、Netlify 或 GitHub Pages。你先批准部署计划,部署期间网站保持在线。
用法:npx vage deploy联系表单
在 Cloudflare 上,一个会把消息发到你邮箱的表单,带防垃圾功能,不需要 JavaScript。
用法:contact: { to, from }尊重隐私的统计分析
Google Analytics、Tag Manager、Plausible 或 Clarity。在你开启之前一直关闭,开启后也会先等访客同意。
用法:ga4: { measurementId: "G-…" }搜索报告和 IndexNow
在终端里查看 Search Console 数据,页面更新时通知搜索引擎。
用法:npx vage report search
开箱即快。
Lighthouse 100 分,0 KB JavaScript。
我们用 Google 的 Lighthouse 工具测试了一个全新的 vagejs 网站。它在每个类别都拿到了满分 100,在模拟的手机网络下,页面不到一秒就加载完成。
100Lighthouse 分数
全新网站在性能、无障碍、最佳做法和 SEO 上的得分。
0.8 s主要内容可见
在模拟的慢速手机网络下(Largest Contentful Paint,最大内容绘制)。
0 KB发送的 JavaScript
页面是纯 HTML。只有你自己加的地方才会有 JavaScript,比如一个可交互组件。
0.5 s构建网站用时
四个页面的入门网站,构建完即可发布。
查看全部数据和测量方法
| 指标 | vagejs 起始模板 | 良好标准 |
|---|---|---|
| 主要内容出现(LCP) | 0.8 s | 低于 2.5 s |
| 布局跳动(CLS) | 0 | 低于 0.1 |
| 页面卡住的时间(TBT) | 0 ms | 越低越好 |
| 首段文字出现(FCP) | 0.6 s | 越低越好 |
| 发送给访客的 JavaScript | 0 KB | 越少越快 |
| 下载的数据量 | 1.7 KB,共 2 个请求 | 越少越快 |
| 构建网站用时 | 0.5 s,共 4 个页面 | 越快越好 |
测量方法:用 npm create vagejs@latest(vagejs 0.16.1)新建的网站,于 2026 年 10 月 28 日使用 Lighthouse 13.5.0 在移动端设置和模拟慢速网络下测试。我们测了两次,两次结果完全相同。这些是实验室数据。Google 还会参考真实访客的数据,你自己网站的数据会取决于你的图片、内容和托管平台。
大家常问的问题。
直截了当的回答。
我可以用 vagejs 搭建哪些网站?
内容型网站,比如公司网站、博客、文档、作品集,以及商店、咖啡馆或诊所的网站。我们的案例页面里有一个在线的作品集、文档网站和面包店网站,你可以照着做。如果是需要登录和实时数据的应用,应用框架会更合适。
vagejs 网站有多快?
一个全新的 vagejs 网站在 Lighthouse 的每个类别都拿到了 100 分,在模拟的慢速手机网络下 0.8 s 就显示出主要内容,并且发送了 0 KB JavaScript。这些是 2026 年 10 月 28 日的实验室结果,你自己网站的数据会取决于你的图片、内容和托管平台。
怎么用 Claude Code、Codex 或 Cursor 搭建网站?
运行 npm create vagejs@latest my-site,在它询问时选择你的助手。它会从第一条提示词开始,和你一起把网站搭起来。也可以直接让你的助手用 vagejs 搭建网站:每个新网站都包含一个 AGENTS.md 文件,告诉它有哪些命令和规则。
vagejs 如何防止 AI 助手发布错误?
vage check 会在每个页面上线前读一遍,并指出每个失效链接、缺失标题或无效结构化数据来自哪个文件,让你的助手先把它修好。指向你没有批准的网站的链接会让检查不通过,而且在你同意之前,什么都不会发布。
我的页面存放在哪里?
存放在项目 src/pages 文件夹里的纯 Markdown 文件中,每个文件的位置决定了它的地址:src/pages/pricing.md 会变成 /pricing/。你的 AI 助手和浏览器编辑器修改的是同一批文件,所以你的全部内容都保存在你自己拥有的文件里。
我怎么发布网站?
运行 npx vage deploy。它会检查网站,给你看一份计划,只有在你同意后才发布到 GitHub Pages、Cloudflare 或 Netlify,而且只有在你的网站有响应时才会说完成。其他任何静态托管平台(比如 Vercel)都可以直接提供构建好的 dist 文件夹。
一条命令就能开始。
一分钟内,你的网站就能跑起来。
npm create vagejs@latest my-site支持者
成为赞助者

