从 wrangler dev 迁移

在大多数情况下，从 wrangler dev 迁移很简单，你可以按照快速入门中的说明操作。 有几点关键差异需要强调：

使用 Cloudflare Vite 插件时，Worker 配置文件（例如 wrangler.jsonc）是输入配置，构建时会创建单独的配置文件作为输出。 此输出文件是构建时配置的快照，并经过修改以引用构建产物。 它用于预览和部署。 运行 vite build 后，运行 wrangler deploy 或 vite preview 将自动定位此输出配置文件。

使用 Cloudflare Vite 插件时，Cloudflare 环境 在开发和构建时应用。 因此 wrangler deploy --env some-env 不适用，应改为运行 CLOUDFLARE_ENV=some-env vite build 来设置要部署的环境。

Worker 配置文件中有各种选项在使用 Vite 时会被忽略，因为它们不再适用或已被 Vite 等效项替代。 如果提供了这些选项，控制台将打印警告并提供后续操作建议。

以下与构建相关的选项由 Vite 处理，在使用 Cloudflare Vite 插件时不适用：

• tsconfig
• rules
• build
• no_bundle
• find_additional_modules
• base_dir
• preserve_file_names

• site — 请改用 Workers Assets。

以下选项有应改用的 Vite 等效项：

有关在 Vite 中配置 Worker 环境的更多信息，请参阅 Vite 环境。

如果在 Vite 配置中为给定 Worker 环境启用了 build.sourcemap ↗，则会自动向输出 Wrangler 配置文件添加 "upload_source_maps": true。 这意味着生成的 source map 默认会上传。 要覆盖此设置，可以在输入 Worker 配置中显式设置 upload_source_maps 的值。