---
title: .meta 资源元信息
description: .meta 目录元信息阅读入口，说明存放边界并指向 DTS 字段定义
navTitle: .meta
---
# .meta 资源元信息

`.meta` 是 SuccApp CLI / SuccApp for VS Code 将服务器元数据同步到本地工作区时生成的目录级索引。它记录同一目录下直接子资源的资源 id、版本、描述、排序、图标、隐藏状态等元信息；服务器数据库中没有名为 `.meta` 的业务文件。

需要查看完整 JSON 结构、字段含义、可编辑性和 `option` 子字段时，优先阅读 DTS。

## 存放方式{#storage}

每个 `.meta` 只描述它所在目录的直接子文件和子目录。文件资源和目录资源自身的元信息，都写在父目录 `.meta` 的同名 key 下；子目录内部的 `.meta` 继续描述该子目录自己的直接子资源。

例如 `/DEMO/app/DEMO.app/index.tpg` 的资源元信息保存在：

```text
DEMO/app/DEMO.app/.meta
```

示例结构：

```json
{
	"index.tpg": {
		"id": "UfOoq4xbolMgpuFPItTdcE",
		"order": 6,
		"creator": "admin",
		"createTime": 1567404411123,
		"modifier": "system",
		"modifyTime": 1658473419755
	}
}
```

本地刚新建的资源可能暂时没有对应 `.meta` 条目；首次 push 成功后，SuccApp 会按服务器返回结果刷新所在目录的 `.meta`。

## DTS 入口{#types}

- 根结构：[`types/meta/file-types/dot-meta.d.ts`](../../../../../dev-types/types/meta/file-types/dot-meta.d.ts)
- 文件类型入口：[`types/meta/file-types/index.d.ts`](../../../../../dev-types/types/meta/file-types/index.d.ts)
- 图片填充类型：[`types/api/succ.types.d.ts`](../../../../../dev-types/types/api/succ.types.d.ts)

## 编辑边界{#edit-boundary}

通常只有在调整资源描述、图标、排序、隐藏状态、标签、自定义属性，或手工移动、重命名资源时，才需要关注 `.meta`。`id`、`revision`、创建人、修改人和时间戳等服务器字段以服务器为准，不要通过修改本地 `.meta` 改变资源身份。

移动或重命名文件时，检查原父目录和目标父目录的 `.meta`；移动或重命名目录时，目录内部 `.meta` 会随目录整体移动，但目录自身的条目仍在父目录 `.meta` 中。推送前应确认 `.meta` 是合法 JSON，避免影响同步和冲突判断。