跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

快速入门

最后更新 查看 MarkdownAgent 设置

从基本的 package.json 开始

package.jsonjson
{
	"name": "cloudflare-vite-get-started",
	"private": true,
	"version": "0.0.0",
	"type": "module",
	"scripts": {
		"dev": "vite dev",
		"build": "vite build",
		"preview": "npm run build && vite preview",
		"deploy": "npm run build && wrangler deploy"
	}
}

安装依赖

npm i -D vite @cloudflare/vite-plugin wrangler

创建 Vite 配置文件并包含 Cloudflare 插件

vite.config.tsts
import { defineConfig } from "vite";
import { cloudflare } from "@cloudflare/vite-plugin";

export default defineConfig({
	plugins: [cloudflare({ viteEnvironment: { name: "worker" } })],
	environments: {
		worker: { build: { sourcemap: true } },
	},
});

Cloudflare Vite 插件会在应用程序根目录中查找 wrangler.jsonc、wrangler.json 或 wrangler.toml。

配置选项请参阅 API 参考。

创建 Worker 配置文件

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "cloudflare-vite-get-started",
	// Set this to today's date
	"compatibility_date": "2026-11-20",
	"main": "./src/index.ts",
	"upload_source_maps": true
}
"$schema" = "./node_modules/wrangler/config-schema.json"
name = "cloudflare-vite-get-started"
# Set this to today's date
compatibility_date = "2026-11-20"
main = "./src/index.ts"
upload_source_maps = true

name 字段指定 Worker 的名称。 上方 Vite 配置中的 viteEnvironment.name 选项将 Worker 的 Vite Environment 设置为 worker。如果省略,插件将使用 Worker 名称(有关详细信息,请参阅 Vite Environments)。 main 字段指定 Worker 代码的入口文件。

有关 Worker 配置的更多信息,请参阅配置。

worker 环境为 Worker 生成源映射。客户端环境保留其现有的源映射设置。

创建 Worker 入口文件

src/index.tsts
export default {
	fetch() {
		return new Response(`Running in ${navigator.userAgent}!`);
	},
};

对此 Worker 的请求将返回 'Running in Cloudflare-Workers!',表明代码正在 Workers 运行时中运行。

开发、构建、预览和部署

现在可以启动 Vite 开发服务器(npm run dev)、构建应用程序(npm run build)、预览构建后的应用程序(npm run preview)以及部署到 Cloudflare(npm run deploy)。

这篇文档对您有帮助吗?