Void 是运行在 Cloudflare Workers 之上、由 Vite 驱动的全栈框架。 用 React、Vue、Svelte 或 Solid 构建界面，在同一个项目里编写服务端代码：路由、数据访问与部署连成一条线，类型从数据库查询一路贯穿到 UI。
bun add -D void && bunx void init// db/schema.ts · 类型的唯一来源
export const users = sqliteTable('users', {
id: integer('id').primaryKey({ autoIncrement: true }),
name: text('name').notNull(),
email: text('email').notNull().unique(),
});// routes/api/users.ts → GET /api/users
export const GET = defineHandler(() => db.select().from(users));
// ↑ 返回类型由 schema 推断// pages/dashboard/index.tsx
const users = await fetch('/api/users');
// ^ { id: number; name: string; email: string }[]SDK、CLI 与平台各自独立，也可以组合使用：从本地开发到团队规模化部署，都由同一套工具覆盖。
Server + Client in one build
通过基于文件的 API 路由、服务端渲染页面，以及面向数据库、存储与 AI 的类型化 API，把服务端与客户端的代码一同构建。类型从数据库查询一路贯穿到 UI。
Build · provision · migrate · deploy
构建应用、开通它所使用的 Cloudflare 资源、执行迁移，并用一条命令完成部署。通过同一个 CLI 管理资源、查看日志以及回滚。
A shared deployment home
在你的 Cloudflare 账户中安装一套共享的部署环境，供团队或客户使用，具备访问控制、资源限额与用量统计，以及关联应用的授权部署。
SDK 的各项功能都是可选且可组合的。你可以从一个 API 开始，也可以直接构建完整的全栈应用。
在 routes/下新建一个文件即可添加端点，导出你想支持的方法。动态段用方括号，catch-all 用省略号，括号目录是路由组，不改变 URL，只整理文件。
routes/
├── api/
│ ├── hello.ts → /api/hello
│ └── users/
│ ├── index.ts → /api/users
│ └── [id].ts → /api/users/:id
└── search/
└── [...query].ts → /api/search/*处理器推断响应类型，类型化 fetch 检查它们的调用方。改动一个字段，TypeScript 立刻指出应用里需要跟着改的地方。
.void/ 路由表await fetch('/api/users');
// ^ { id, name, email }[]导入即启用。开发时 Void 提供本地资源，部署时自动开通真实的 Cloudflare 资源，不需要手写 wrangler 配置。
import { db } from 'void/db';
import { kv } from 'void/kv';
import { ai } from 'void/ai';
// 部署时自动开通资源Vite 使用 Cloudflare 的运行时在本地运行你的应用。本地看到的行为，就是边缘节点上的行为。
$ npm run dev
➜ Local: localhost:5173
➜ workerd ready in 41msloader 读取数据成为带类型的 props，action 处理表单与其他变更，然后更新页面，不需要手写 API 再对接客户端状态。
// users/index.server.ts
const loader = defineHandler(
() => db.select().from(users)
);两种目标使用完全相同的应用 API。选择自托管的 Void 平台，可以获得共享访问控制、保留的部署历史与后台管理。
--platform cloudflare
部署到你自己的 Cloudflare 账户。适合个人项目、独立产品，以及希望完全掌控账户与账单的场景。
--platform void
在你的 Cloudflare 账户中安装一套共享环境，供团队或客户使用。开发者连接它的 URL、登录，然后部署自己的应用。
| 能力 | Cloudflare | 核心自托管平台 |
|---|---|---|
| 静态站点、SPA 与原生页面 SSR | ||
| 路由规则、WebSocket、队列、Cron 与 ISR | ||
| D1、KV、R2 与经 Hyperdrive 的外部 SQL | ||
| Workers AI 与第三方模型请求 | 你的账户与网关 | 安装方网关与代理 |
| 运行时日志 | Cloudflare 实时 tail | 保留的平台日志 |
| 应用回滚 | Worker 版本 | 保留的平台部署记录 |
| 带类型的 Durable State 与原生 Durable Objects | ||
| 沙箱 | 需要 Workers Paid 与 Docker | 需要平台账户为 Workers Paid |
| 自定义应用域名 | 核心安装不包含 | |
| 用户后台与托管的 GitHub 构建 | 不需要 | 标准安装不包含 |
团队平台需要 Workers for Platforms 与相应的基础设施；具体功能取决于安装时的配置。阅读平台安装指南 →
完整的中文指南，按主题分组。站内搜索支持 Ctrl / ⌘ + K。
在一个空目录中运行安装与初始化命令，选择你的 UI 框架与部署目标，然后执行npx void deploy，Void 会构建应用、开通资源、执行迁移，并打印出你的部署地址。
bun add -D void && bunx void init