快速入门

你可以为新 Worker 或现有 Worker 创建 Preview。无需先将 Worker 部署到生产环境，即可创建第一个 Preview。

Worker Previews 需要 Wrangler 4.135.0 或更高版本。请更新项目依赖，因为项目内命令不会使用更新的全局安装。

npm i -D wrangler@latest

yarn add -D wrangler@latest

pnpm add -D wrangler@latest

bun add -d wrangler@latest

在 Wrangler 配置文件中添加 previews 块。顶层设置定义生产环境，previews 块定义 Preview 设置。如果 Preview 不需要单独设置，previews 块可以为空。

{
  // ...
  "vars": {
    "ENVIRONMENT": "production"
  },
  // ...
  "previews": {
    // ...
    "vars": {
      "ENVIRONMENT": "preview"
    }
    // ...
  }
}

[vars]
ENVIRONMENT = "production"

[previews.vars]
ENVIRONMENT = "preview"

要确定哪些设置应放在顶层、哪些应放在 previews 中，请参阅previews 块中应包含什么。

你在仪表板中添加或导入的设置，也必须复制到 Wrangler 配置文件中。

在本地或现有 CI 工作流中运行相同的 Preview 命令：

npx wrangler preview

yarn wrangler preview

pnpm wrangler preview

Preview 名称默认使用当前 Git 分支。要指定名称，添加 --name <PREVIEW_NAME>。

要自动将 Preview URL 发布到拉取请求或合并请求，连接 Git 仓库并使用 Workers Builds。新 Worker 默认使用 Worker Previews。如果现有 Worker 已使用 Workers Builds，请完成一次性设置。

部署成功后会返回始终指向最新变更的 Preview URL。同时返回每次部署的 Unique Deployment URL，以便访问该 Preview 部署历史中的早期版本。

• 配置 - 配置变量、密钥、绑定和 Previews Base。
• 资源与隔离 - 决定哪些资源共享或隔离。
• 限制 - 查看当前支持缺口与变通方案。
• 示例 - 将 Preview 部署加入 CI。