---
title: 预览文件
description: 说明 AI 修改 SuccApp 元数据文件后，如何编译、推送并在浏览器或设计器中打开服务器版本。
navTitle: 预览文件
---
# 预览文件

浏览器、预览页和设计器打开的是服务器上的元数据版本，不是本地工作区文件。AI 修改本地文件后，需要先把文件同步到测试服务器，再打开页面验证。

## 推荐顺序{#flow}

1. 编译：先执行 `succapp workspace file compile <path>`，校验当前文件或相关文件是否能通过服务器编译。
2. 推送：编译通过后执行 `succapp workspace push <path>`，把本地修改提交到测试服务器。
3. 打开：推送成功后执行 `succapp workspace file open <path>`，在浏览器中验证服务器版本。

```bash
succapp workspace file compile path/to/file.dash
succapp workspace push path/to/file.dash
succapp workspace file open path/to/file.dash
```

## 打开方式{#open}

| 场景 | 命令 |
| --- | --- |
| 打开页面、仪表板、报表或应用的运行效果 | `succapp workspace file open <path>` |
| 打开设计器或编辑页 | `succapp workspace file open --edit <path>` |
| 只查看本地路径、服务器路径和浏览器 URL | `succapp workspace file resolve <path>` |
| 只输出可分享的查看 URL | `succapp workspace file resolve <path> --url=view` |
| 只输出可分享的编辑 URL | `succapp workspace file resolve <path> --url=edit` |

## 本地变化提示{#local-changes}

本地新增文件还没有 push 时，服务器上没有对应资源，浏览器可能返回 404。本地修改文件还没有 push 时，浏览器看到的是服务器旧版。

`succapp workspace file open <path>` 会在打开前检查本地文件和同步状态。如果本地有未推送变化，先 push 再 open；只有明确需要打开服务器旧版排查问题时，才使用：

```bash
succapp workspace file open <path> --force
```

更多产品运行效果检查见[产品验证](./product-verification.md)。