扣子工作流中消息节点变量不渲染的根本原因是变量未被正确导出或格式错误；需确认变量在侧边栏存在、严格使用{{var_name}}格式、对空值/列表/数字等做适配处理，并通过调试节点验证变量实际值与类型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在扣子工作流中，消息节点输出内容始终显示原始变量名而非真实值，比如{{product_name}}原样打出、图片链接不自动加载、列表数据堆成一串，导致用户看到的是一堆代码而非可读信息。这通常不是模型没响应，而是变量根本没被正确解析或类型不匹配。
确认变量是否被平台识别
打开工作流编辑页 → 点击「消息」节点 → 在提示词框顶部点击「插入变量」按钮 → 查看弹出侧边栏中是否有你想要的变量名（如 product_name、image_url）。
如果变量没出现在侧边栏里，说明它未被上游节点导出或命名错误。此时无论你在提示词里怎么写 {{product_name}}，最终都会原样输出。
变量必须由上游插件或大模型节点勾选「导出为变量」才能进入侧边栏，且导出时填写的变量名要和提示词中完全一致，【大小写和下划线一个字符都不能错】。
修复变量渲染失败的三种方法
方法一：检查并修正变量书写格式
所有变量必须用双大括号包裹，且内部【不能有空格】：写成 {{product_name}} ✅，写成 {{ product_name }} ❌。
方法二：处理空值或列表类变量
若变量可能为空（如用户未上传图），直接嵌入会导致语义断裂。例如提示词写“主图：{{main_image}}”，而 main_image 为空，结果会输出“主图：”。
对列表变量，必须用 list_join 函数展开：{{image_list|list_join:"\n"}}，否则会显示为 ["url1","url2"] 这样的原始字符串。
方法三：强制类型转换（仅限数字/布尔等）
当变量实际是数字但提示词中需拼接文字时，直接 {{price}} 可能报错或不显示。改用 {{price|str}} 显式转为字符串；布尔值同理，{{is_on_sale|str}} 可输出 "True" 或 "False"。
验证变量是否真正生效
第一步：在消息节点前添加一个「调试」节点
勾选「记录输入参数」和「记录输出参数」，运行工作流后点开该节点右侧的【DEBUG】快照。
第二步：查看快照中的 params 字段
确认你要用的变量是否已存在，值是否为预期类型（String / Array / Number）。如果值为 null 或 missing，说明上游未成功赋值。
第三步：复制快照里的实际变量值，粘贴到消息节点提示词中做静态测试
例如快照显示 "product_name": "冰丝防晒衣"，那就把提示词临时改成“商品名：冰丝防晒衣”，运行看是否正常显示。能显示，就证明是变量解析问题；不能显示，说明消息节点本身配置异常。
这一步做完后，变量就能在消息中正确渲染了。
