---
title: 发布和重新发布
description: 将当前店铺前台上线、发送后续更改或重试失败的发布。
---

**入口路径：** 工作区 → 选择一个店铺 → **店铺前台** → **发布**、**发布更改**或**重新发布**（标签取决于发布状态）

![Runner 发布控件和检查项](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgT7ZAYgD7lIPXqUA4xQWKLGpygc8jMtzfNJri)

## 本指南内容

使用 Runner 根据当前店铺状态显示的发布操作，按确认流程等待最终结果；如果系统提供公开 URL，请打开或复制该地址。

## 为什么以及何时发布

发布会把当前项目版本放到公开的店铺 URL。首次上线时使用**发布**；店铺已有可正常访问的公开 URL 时使用**发布更改**；上次发布失败或未完整结束时使用**重新发布**。

保存设计模式编辑、恢复版本或看到正确的预览本身不会更新公共店铺。

发布流程中的后续引导会因工作区而异。部分工作区会在发布前显示支付警告，发布后只显示成功提示；另一些工作区会先显示店铺运营检查，并在成功后打开结账状态引导。

## 可用性和先决条件

- 完成[发布就绪检查清单](./prepare-to-publish)。
- 使用最新的**当前**店铺前台版本。
- 等待 Runner 完成正在处理的请求。
- 如果按钮说不可用，请重新连接店铺前台工作区。
- 发布可能受您的套餐或项目资格限制。
- 当发布需要更高套餐时，**升级**会打开 Plus 月度套餐确认页面。购买前，您可以从该确认页面返回完整套餐列表。

## 打开发布流程

1. 打开您的项目。
2. 选择**店铺前台**。
3. 选择工具栏右侧的发布按钮。
4. 阅读**确认部署**并等待构建检查。
5. 解决或明确确认每个警告。
6. 仅在检查成功后选择**确认**。

## 选择正确的操作

| 标签 | Runner 何时显示它 | 选择它会做什么 |
| --- | --- | --- |
| **发布** | 店铺尚未完成首次发布。 | 针对当前版本检查访问权限、设置、变更和构建状态。 |
| **发布更改** | 已完成的发布有可用的公开 URL。 | 执行相同检查，然后把当前版本更新到已经上线的店铺。 |
| **重新发布** | 上次发布失败，或完成时没有可用的 URL。 | 重新执行一轮完整检查并尝试发布。 |
| **启动中… / 准备中… / 构建中… / 保存检查点中… / 发布中…** | 发布步骤正在进行中。 | 按钮被禁用并报告进度。等待成功或失败。 |

## 发布及后续引导控件

| 控制 | 选择时会发生什么 |
| --- | --- |
| **确认部署**中的**取消** | 关闭对话框并在发布开始前放弃此发布尝试。 |
| **使用 AI 修复** | 将构建失败发送给 Runner 进行修复，不发布。 |
| **重试检查** | 在工作区访问失败后重新运行构建检查。 |
| **确认** | 在构建检查和必需的确认完成后启动发布。 |
| 已发布的 URL | 在新标签页中打开公共店铺前台。 |
| **复制**或**复制 URL** | 将公共店铺地址复制到您的剪贴板。 |
| **查看店铺** | 在结账状态引导中，于成功发布后打开公开店铺前台。 |
| **连接 Stripe** | 在显示支付状态的流程中，当结账未就绪时启动支付连接。访问权限可能取决于您的工作区角色。 |
| **暂时跳过** | 在显示时关闭发布后支付提示。店铺前台可以在结账保持暂停时保持可浏览。 |
| **重试结账状态** | 发布后的引导中，如果状态不可用，再次检查是否已有启用的 Stripe 连接。 |
| **关闭** | 结账已经连接时，关闭成功后的结账状态引导。 |
| 已发布网站菜单 | 在桌面上显示时，打开**查看网站**、**复制 URL**、**域名设置**和最后发布的信息。 |

## 等待发布的最终结果

1. 确认按钮标签与您的意图相符。
2. 选择它并等待构建检查完成。
3. 如果出现**使用 AI 修复**，请用它处理问题，检查修复后的预览，再重新开始发布。
4. 如果出现警告，而您需要正常使用结账或日常店铺运营，请先解决相应的基础设置问题。
5. 选择**确认**。
6. 保持项目打开，直到 Runner 报告成功或失败。
7. 成功后打开公开 URL。出现结账状态引导时，选择**查看店铺**；部分工作区只会显示成功提示，然后返回店铺前台。
8. 如果 URL 不可用，请关闭引导窗口，待工作区准备就绪后使用**重新发布**。
9. 如果发布失败，请查看失败信息、修复问题并选择**重新发布**。不要假定本次更改已经上线。

## 发布状态和故障排除

| 您看到的内容 | 含义 | 要做什么 |
| --- | --- | --- |
| **店铺已发布** / **您的店铺已上线** | Runner 完成了发布并有公共 URL。 | 打开 URL 并验证客户旅程。 |
| **发布完成**，带有**店铺链接不可用** | 发布完成，但引导中没有可用链接。 | 关闭对话框，确保工作区准备好，然后使用**重新发布**。 |
| **店铺发布失败** | 发布未完成。 | 查看错误或要求 Runner 修复它，然后使用**重新发布**。 |
| **您的店铺无法构建** | 当前项目在发布前失败。 | 选择**使用 AI 修复**，不要原样重试。 |
| 按钮说**重新连接沙箱以发布** | Runner 无法到达店铺前台工作区。 | 重新连接它，然后重新运行检查。 |
| 按钮显示**等待 Runner 完成** | 仍有请求正在处理。 | 等待请求得到最终结果后再发布。 |
| 公共店铺显示较旧的版本 | 最新的项目更改未成功发布。 | 检查当前版本，然后使用**发布更改**并再次验证。 |

## 相关指南

- [准备发布](./prepare-to-publish)
- [验证线上店铺和结账](./live-store-and-checkout)
- [连接自定义域名](./custom-domains)