---
title: 变量检查
---

变量检查（Variable Inspect）是一个位于工作流应用底部的看板，记录各个节点在执行任务后的输入输出数据，帮助开发者快速定位问题和验证数据流转。

## 功能价值

[变量](/zh-hans/guides/workflow/variables)是连接节点之间的重要桥梁，也是实现动态流程控制的基础。在工作流应用中，变量记录了用户输入的数据，以及各节点内的输出数据，例如大模型输出，工具调用结果、对话历史上下文及环境配置参数等。

变量检查视图将在节点运行后，自动缓存每个节点所接受的输入参数，以及执行任务后各节点输出变量内的数据。提供以下核心功能：

- **实时变量监控**：自动捕获并显示节点执行后产生的所有变量值，记录工作流的输入和输出数据。
- **缓存变量值编辑**：允许开发者手动修改大多数类型变量的值，而无需重新运行上游节点，便于模拟不同场景。
- **异常数据追踪**：展示变量的实际值及其类型，便于识别格式不符、缺字段、类型错误等问题。
- **全局状态管理**：在单一界面集中展示变量信息，包括系统变量、环境变量和节点内的自定义变量等。

通过变量检查，开发者可以直观地观察上次运行时各个节点的输出变量，同时可以在其中直接进行修改，观察新数据对于后续节点的影响，更快地定位问题并验证数据，提升应用的调试效率。

## 使用方法

变量检查位于画布底部，随着工作流运行实时更新变量值。

当某个节点运行后，其输出变量将自动出现在变量检查中，便于开发者查找。该功能可以帮助开发者管理当前工作流应用内所涉及的所有变量所对应的数据，它展示工作流中所有已创建变量及其当前值。

![](https://assets-docs.dify.ai/2025/06/38f26d7339f64abfdfb6955b1c34f4ae.png)

下文将以一个“查询外部数据库”应用作为案例，演示变量视图的操作方法。该应用的流程是查询外部数据库的应用。LLM 节点在接受自然语言后，自动转译为 SQL 语法，向外部数据库发送请求并接受数据。

> 点击[此处](https://assets-docs.dify.ai/2025/06/ac4da5ed5506f8a34aae7f0b88323f37.yml)下载 DSL 应用文件。

### 查看

节点运行后，输出变量会自动显示在变量检查视图内，点击变量查看详细内容。

![](https://assets-docs.dify.ai/2025/06/94a4741c25204db5fd1281ec475093d9.png)

### 编辑

点击变量值修改内容。修改后，下游节点可以使用新的变量值。

<Info>
    编辑变量值后，不影响当前节点在“上次运行”内已有的存储记录。    
</Info>

**用法示例：**

<Steps>
  <Step title="默认运行结果">
    用户输入“查询所有用户数据”命令，LLM 节点自动生成了 `SELECT * FROM users;` 命令，数据库正确返回了所有数据。
    <img src="https://assets-docs.dify.ai/2025/06/dcf4b0048bf1ed802369ab10731a4848.png" />
  </Step>
  <Step title="修改变量值后的结果">
    用户在变量面板中手动将 SQL 修改为 `SELECT username FROM users;`，随后仅重新运行数据库节点，系统将返回用户名列表。

    手动修改变量值后，手动运行下游的数据库节点即可重新查询新的数据，而无需重新运行整个工作流。
    <img src="https://assets-docs.dify.ai/2025/06/fb8c49fc0c8c63866f1a9379e8752d9e.png" />
  </Step>
</Steps>

### 回退

点击编辑框右上角的回退按钮，恢复该变量的原始值。

![](https://assets-docs.dify.ai/2025/06/b713290543a0feb95ecab65336e97483.png)

### 重置所有变量

点击左上角 Reset all 按钮，清空所有变量缓存。

{/*

支持展示的变量类型

以下变量类型将会在变量视图内进行展示，且部分变量允许被编辑。

| 变量类别 | 示例变量 | 描述 |
|---------|---------|------|
| **系统变量** | sys.query, sys.user_id, sys.conversation_id | 系统提供的当前会话信息 |
| **环境变量** | OPENAI_KEY, SECRET | 系统环境配置 |
| **自定义变量** | [用户定义名称], 文件变量 | 用户在开始节点中自定义的输入变量，上传的文件变量 |
| **节点输出变量** | output, structured_output, usage, loop_variable, iteration_variable | 各节点的输出结果 |

*/}

{/*
Contributing Section
DO NOT edit this section!
It will be automatically generated by the script.
*/}

---

[编辑此页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/debug-and-preview/variable-inspect.mdx) | [提交问题](https://github.com/langgenius/dify-docs/issues/new?title=文档问题%3A%20ble-insp&body=%23%23%20问题描述%0A%3C%21--%20请简要描述您发现的问题%20--%3E%0A%0A%23%23%20页面链接%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs%2Fblob%2Fmain%2Fzh-hans/guides/workflow/debug-and-preview%2Fvariable-inspect.mdx%0A%0A%23%23%20建议修改%0A%3C%21--%20如果有具体的修改建议，请在此说明%20--%3E%0A%0A%3C%21--%20感谢您对文档质量的关注！%20--%3E)

