---
title: 使用版本历史
description: 预览早期的店铺版本，并在不删除较新历史记录的情况下恢复一个版本。
---
**入口路径：** 工作区 → 选择一个商店 → **店铺** → **版本历史**
## 本指南内容
比较店铺版本，预览早期的就绪版本，并在需要时将其内容恢复为新的当前版本，同时保留现有历史记录。
## 为什么以及何时使用版本历史
当您需要了解发生了什么变化、查看早期设计或恢复在最近请求之前更好的内容时，请使用版本历史。预览是只读的。恢复会改变项目，因此请先查看确认。
## 可用性和前提条件
- 打开至少有一个店铺版本的项目。
- 历史预览和恢复仅适用于 Runner 可以成功加载的版本。
- 在恢复之前，请等待 Runner 完成活跃请求。
- 版本历史在使用基于检查点的店铺体验的工作区中是有条件的。
- 某些已完成的对话工作卡也显示条件版本标签、精确版本预览和未发布当前版本的**发布**操作。这些卡是快速入口；此页面仍然是完整的比较和恢复视图。
## 打开版本历史
1. 打开您的项目。
2. 选择**店铺**。
3. 在店铺工具栏中选择**版本历史**。
4. 从最新版本向后查看卡片。
## 版本历史控件
| 控件 | 使用原因 | 选择时会发生什么 |
| --- | --- | --- |
| **返回** | 离开版本列表。 | Runner 返回到店铺视图。 |
| 版本截图 | 检查捕获的外观。 | 当可用时，截图在较大的图像查看器中打开。 |
| **查看完整差异** | 查看更改的详细记录。 | Runner 在新标签页中打开该版本的更改详情。 |
| **预览** / **预览此版本** | 在不恢复的情况下查看早期就绪版本。 | 店铺切换到标记为**预览 v…** 的临时历史预览。最新项目版本和实时商店不会改变。 |
| **返回最新** / **返回当前** | 结束历史预览。 | Runner 重新加载最新的当前店铺版本。 |
| **恢复** | 重用早期版本的内容。 | Runner 打开**恢复到 v…？**。确认会创建具有该内容的新最新版本；选定的版本、较新的版本和历史记录保持不变。 |
| **更多操作** | 在紧凑布局上访问卡片操作。 | 菜单打开，显示该版本的可用操作，例如预览、恢复或查看完整差异。 |
| **发布**当前版本 | 开始发布最新版本。 | Runner 打开发布检查。它不直接发布历史预览。 |
## 阅读版本卡片
| 标签或状态 | 含义 |
| --- | --- |
| **最新**或**当前版本** | 这是最新的项目版本。 |
| **已发布** | 此版本与已完成的发布相关联。它不能证明结账现在正在工作。 |
| **构建中…** | Runner 仍在创建版本。预览和恢复可能不可用。 |
| **构建失败** | 此版本未达到就绪状态。使用其错误上下文要求 Runner 修复。 |
| 文件更改计数 | 该版本的添加、更改或删除文件的摘要。 |
| 时间 | 记录版本的时间。 |
| 描述 | 版本的记录摘要（如果可用）。 |
## 安全地预览和恢复
1. 在要检查的版本上选择**预览**。
2. 确认工具栏显示**预览 v…**，以便您不会将其误认为是最新版本。
3. 检查相关页面和设备布局。
4. 如果您只需要比较，请选择**返回最新**。
5. 要恢复较旧的内容，请选择**恢复**。
6. 阅读确认：Runner 将添加新版本并保留现有历史记录。
7. 仅在 Runner 空闲时确认恢复。
8. 在发布前在预览中查看新的当前版本。
## 状态、限制和故障排除
| 您看到的内容 | 含义 | 要做什么 |
| --- | --- | --- |
| **还没有版本历史** | 仅存在当前起始状态，或没有可用的历史记录。 | 继续工作；在 Runner 记录另一个版本后返回。 |
| **加载版本历史中…** | Runner 正在检索卡片。 | 保持面板打开直到完成。 |
| **无法加载版本历史** | 列表请求失败。 | 选择**重试**。 |
| **无法加载此版本的预览** | 无法启动该历史预览。 | 返回当前并尝试另一个就绪版本。 |
| 恢复被禁用 | Runner 处于活跃状态或版本不可恢复。 | 等待 Runner 完成或选择就绪版本。 |
| **代理工作时无法恢复** | 恢复会与活跃任务冲突。 | 让任务达到终止状态，然后重试。 |
| 恢复的内容不是实时的 | 恢复创建了项目版本，而不是发布。 | 查看它，然后选择**发布更改**。 |
## 相关指南
- [预览您的商店](./preview-your-store)
- [发布和重新发布](./publish-and-republish)
- [排查预览和发布问题](./troubleshoot-preview-and-publishing)