---
title: 检查和编辑店铺前台代码
description: 打开 Runner 的条件代码编辑器，保存专注的文件更改，查看 Git 更改，并避免丢失未保存的工作。
---

代码编辑器让您检查或对当前预览后面的店铺前台文件进行专注的更改。仅当视觉编辑或 Runner 请求不是更好的选择时才使用它。

## 本指南内容

打开条件代码编辑器，保存一个专注的文件更改，返回预览以验证它，并将提交、推送和发布作为单独的有意操作。

## 入口路径

打开店铺项目 → **店铺前台** → **打开代码编辑器**。

## 开始前

- 等待项目工作区和店铺前台预览连接。
- 仅当您了解打算更改的文件时才使用代码编辑器。
- 在关闭其选项卡或对话框前保存每个更改的文件。关闭未保存的文件不会显示确认。
- 保存的文件会更改项目工作区，但不会自动提交、推送、发布或在预览中证明正确。
- 仅当您有权更改项目配置的 Git 远程时才使用 **提交** 和 **推送**。

## 编辑器控件和点击结果

| 控件或状态 | 使用它后会发生什么 |
| --- | --- |
| **打开代码编辑器** | 打开全高 **代码编辑器** 对话框。关闭对话框会将店铺前台面板返回到预览。 |
| 文件图标 | 显示可搜索的店铺前台文件树。展开文件夹会加载其内容；选择文件会在选项卡中打开它。 |
| 文件选项卡 | 将编辑器切换到该打开的文件。橙色点表示选项卡包含未保存的更改。 |
| 文件选项卡上的关闭图标 | 关闭该选项卡。Runner 不会询问未保存的更改，所以请先保存。 |
| 代码编辑器 | 让您更改活动文件。键入会更改打开的选项卡，但不会自动保存文件。 |
| macOS 上的 **Command-S** 或 Windows/Linux 上的 **Control-S** | 将活动文件保存到连接的项目工作区。成功后橙色未保存指示器会清除。 |
| Git 分支图标 | 打开当前分支、更改的文件列表、提交表单和推送控件。选择更改的文件会打开其差异。 |
| **暂存** / **取消暂存** | 从下一个提交中添加或删除一个文件。它不会保存未保存的编辑器选项卡。 |
| **全部暂存** / **全部取消暂存** | 对相应列表中的每个文件应用相同的暂存选择。在使用任一操作前查看列表。 |
| **提交消息** | 记录将附加到下一个提交的说明。 |
| **提交** | 当消息不为空时从暂存的文件创建提交。未暂存和未保存的更改保留在该提交之外。 |
| **推送** | 立即发送领先于配置的远程的提交。此面板中没有第二个确认。 |
| **刷新** | 请求连接的项目工作区的最新 Git 状态。 |

## 进行并验证一个专注的编辑

1. 确认项目名称和预览中的当前店铺前台。
2. 选择 **打开代码编辑器**。
3. 保持文件视图打开，展开所需的文件夹，并选择一个文件。
4. 在更改前阅读现有内容。
5. 进行最小的预期编辑。
6. 按 **Command-S** 或 **Control-S** 并确认橙色点消失。
7. 关闭代码编辑器并在预览中查看受影响的页面。
8. 当更改可能影响任一布局时检查桌面和移动布局。
9. 如果结果错误，返回编辑器并更正它，或要求 Runner 修复特定文件和可见问题。

保存仅证明 Runner 写入了文件。预览仅证明当前项目可以显示它。发布和实时客户旅程仍然是单独的检查。

## 仅在需要时提交和推送

1. 保存您打算包含的每个文件。
2. 打开 Git 分支视图。
3. 选择每个更改的文件并查看其差异。
4. 对预期的文件使用 **暂存**。当存在不相关的更改时避免 **全部暂存**。
5. 输入清晰的 **提交消息**。
6. 选择 **提交** 并等待 Git 状态刷新。
7. 仅在确认分支和远程工作流后使用 **推送**。该操作立即启动。
8. 返回预览并验证可见结果。成功的提交或推送不会发布店铺前台。

## 故障排除

| 状态 | 含义 | 要做什么 |
| --- | --- | --- |
| **打开代码编辑器** 缺失 | 此功能未为此项目启用。 | 使用设计模式或要求 Runner 进行更改。不要依赖复制的内部路由。 |
| **连接到沙箱中…** | 项目工作区还未连接。 | 保持项目打开，在工作区重新连接后重试。 |
| 文件树旋转器 | Runner 正在加载当前文件夹。 | 在重复选择另一个文件夹前等待。 |
| 选择文件无效 | 文件无法读取或工作区断开连接。 | 检查连接，然后再次选择文件。 |
| 保存后橙色点仍然存在 | 文件未成功保存。 | 保持选项卡打开，阅读错误消息，如果必要在重新连接后重试。 |
| **从树中打开文件** | 没有活动文件。 | 在文件视图中选择一个文件。 |
| **无更改** | Git 不报告保存的文件更改。 | 保存编辑器选项卡，然后选择 **刷新**。 |
| **提交** 被禁用 | 没有暂存的文件或没有提交消息。 | 暂存预期的保存文件并输入消息。 |
| **推送** 被禁用 | 分支在远程前没有本地提交，或推送正在运行。 | 提交预期的更改或等待当前推送。 |
| **无法加载 git 状态** | Runner 无法读取存储库状态。 | 选择 **重试**。在状态加载前不要暂存或推送。 |
| 下箭头计数显示分支落后 | 远程包含工作区中不存在的提交。 | 在推送前停止并询问项目所有者如何安全地更新分支。 |
| 保存、暂存、提交或推送错误 | 操作未完成。 | 保持当前状态，阅读错误，仅在检查连接和权限后重试。 |

## 相关指南

- [预览您的店铺](./preview-your-store)
- [使用设计模式](./design-mode)
- [使用版本历史](./version-history)
- [发布和重新发布](./publish-and-republish)
- [故障排除预览和发布](./troubleshoot-preview-and-publishing)