---
title: 引用检查
navTitle: 引用检查
---
# 引用检查

引用检查用于确认 AI 修改没有破坏文件、字段、组件、数据集、动作节点、图片、模型、页面、权限和脚本之间的关系。

## 常见引用{#references}

| 引用 | 常见位置 |
| --- | --- |
| 文件路径 | `referenceResources`、跳转动作、数据集路径、模板引用。 |
| 字段名 | `.tbl`、`.query`、数据集过滤、报表单元格、脚本。 |
| 组件 ID | 页面事件、联动、表达式、状态保存。 |
| 数据集 ID 或名称 | 组件绑定、过滤条件、脚本、报表区域。 |
| 动作节点 ID | `.afl`、页面事件、流程节点参数。 |
| `.meta` | 目录直接子资源的描述、排序、资源 ID 和同步关系。 |

## 检查方法{#methods}

1. 修改文件名、字段名、组件 ID 或数据集 ID 前，先全局搜索旧值。
2. 修改 `referenceResources` 后，确认 `targetPath` 指向的文件存在。
3. 新增或删除文件后，检查所在目录的 `.meta`。
4. 修改模型字段后，检查页面、报表、查询、权限和脚本引用。
5. 修改动作节点后，检查入口、参数传递和错误处理。
6. 使用产品设计器打开页面、报表或程序流，检查是否有缺失引用提示。

## AI 提示词{#prompt}

可以让 AI 做一次引用自查：

```text
请检查当前修改是否影响引用关系。
重点看 referenceResources、.meta、字段名、组件 ID、数据集 ID、动作节点 ID 和脚本调用。
只输出风险和需要人工确认的文件，不要继续修改。
```

## 常见风险{#risks}

1. 改了显示名，同时误改稳定字段名。
2. 复制组件后没有调整组件 ID。
3. 删除文件后，所在目录 `.meta` 中的对应条目或引用路径仍保留。
4. 移动页面后跳转或图片引用失效。
5. 改模型字段后，报表和脚本仍引用旧字段。