---
title: 元数据静态检查
navTitle: 元数据静态检查
---
# 元数据静态检查

元数据静态检查用于在推送测试服务器前发现明显结构问题，例如 JSON 语法错误、文件类型不匹配、关键字段缺失、DTS 类型不一致、引用路径异常和脚本入口配置错误。它适合在 AI 修改后快速拦截低级错误，但不能替代产品验证。

## 检查依据{#source}

静态检查通常结合以下依据：

1. 元数据手册中的文件类型、通用结构、`.meta` 和引用路径说明。
2. [`/dev-types/`](../../../../dev-types/index.json) 中发布的 DTS 类型声明。
3. 当前工作区中的同类文件和历史写法。
4. SuccApp CLI 当前可用的工作区检查能力。
5. SuccApp CLI 的服务器编译校验能力，用于检查 JSON 配置、表达式等元数据语义。

## 使用方式{#usage}

常见检查方式：

1. 在 VS Code 中打开元数据文件，查看 JSON 语法、类型提示和编辑器诊断。
2. 执行 **SuccApp: 初始化工作区**，刷新类型声明和编辑器辅助配置。
3. 使用 `succapp workspace repair --dry-run --only=workspace-support` 检查推荐设置是否缺失。
4. 对旧版本元数据先执行 `succapp workspace file upgrade --dry-run` 查看升级候选。
5. 对需要编译的元数据文件执行 `succapp workspace file compile <path>`，把本地内容发送到当前服务器做编译校验。
6. 执行 `succapp workspace repair --dry-run` 预演工作区结构、本地同步基线和同步状态修复。

## 局限{#limits}

静态检查不能证明：

1. 引用路径一定存在。
2. 字段名、组件 ID、数据集 ID 一定被正确引用。
3. SQL、脚本、表达式和权限配置运行正确。
4. 产品设计器一定能按预期渲染。
5. 业务口径和客户需求正确。

因此静态检查通过后，还要继续做[引用检查](./reference-check.md)、[产品验证](./product-verification.md)和[Diff 审查](./diff-review.md)。