飞书卡片入门：是什么、有什么用、怎么让智能体帮你做一张

飞书群里天天有人发「今日数据日报」「系统告警」，绝大多数人还在用最原始的方式：复制一段文字、贴一张截图。而飞书卡片可以把这些内容变成带颜色、带布局、带表格的富媒体消息——它不是截图，本质是一段 JSON，飞书 App 收到后自动解析成卡片界面。

这篇写给刚接触卡片的人：它到底是什么、为什么值得用、以及怎么让智能体 30 秒帮你生成一张，最后附上我踩过的 5 个高频坑。

适用：飞书群主 / 运营 / 开发者 / 想用智能体自动化的人 ｜ 更新：2026-09-01

一、飞书卡片是啥？

一句话：飞书卡片 = 发在群里的、带颜色/布局/表格的富媒体消息。

它不是一张图片，而是一段 JSON 代码。你（或你的智能体）把 JSON 发给群，飞书客户端收到后自动渲染成好看的卡片界面。这意味着它可更新、可转发、可交互，这是截图永远做不到的。

二、为什么值得用：三大好处

1. 好看 — 有颜色、有布局、有设计感，不再是白底黑字
2. 好读 — 关键数字一眼找到，不需要在长文字里扒
3. 好用 — 可以原地更新、可以转发、可以做交互按钮

三、应用场景对比

四、卡片结构：三件套

┌──────────────────────────────────┐
│  📊 今日数据日报 ← header（标题）│
├──────────────────────────────────┤
│  KPI 概览                        │
│  ┌──────┐ ┌──────┐ ┌──────┐     │
│  │ 1234 │ │ 89   │ │ 3    │     │  ← body.elements（正文组件）
│  │活跃  │ │订单  │ │异常  │     │
│  └──────┘ └──────┘ └──────┘     │
│  排行榜                           │
│  🥇 张三  12345                  │
│  🥈 李四  9876                   │
│  🥉 王五  5432                   │
└──────────────────────────────────┘

• header：标题 + 颜色（蓝/红/绿/紫等）
• body.elements：正文区（文字块、分栏卡片、表格）
• config：全局设置（宽度模式、字体大小等）

五、两种生成方式

方式一：手写 JSON Schema

最基础的骨架长这样：

{
  "schema": "2.0",
  "config": { "width_mode": "fill" },
  "header": {
    "title": { "tag": "plain_text", "content": "标题" },
    "template": "blue"
  },
  "body": { "elements": [] }
}

调试入口：飞书官方的卡片预览工具。

方式二：让智能体写（推荐）

手写 JSON 容易在缩进、引号、组件层级上翻车。推荐做法：直接把需求丢给智能体，比如：

「帮我生成一张飞书卡片：蓝色标题『今日数据日报』，正文三个 KPI 数字块（活跃 1234 / 订单 89 / 异常 3），下面一个排行榜前三名，schema 2.0」

智能体会直接输出一段可用的 JSON，你复制到卡片预览工具里检查，满意就发群。30 秒从需求到成品，不用记任何组件语法。

六、常见踩坑（高频 5 条）

1. 卡片全白 — 99% 是忘了写 "schema": "2.0"，加在最外层即可
2. 手机布局裂了 — column_set 的 flex_mode 设 "stretch"，自动上下堆叠
3. 表格不显示 — table 不能放在 column_set 或文字块里，必须挂在卡片根节点
4. 颜色奇怪 — 只用官方 6 种：blue-50 / green-50 / red-50 / violet-50 / grey-50 / purple-50
5. 多人看到不同内容 — config 加 "update_multi": true

七、进阶能力（以后再用）

• 字体大小 PC/手机分离 — config.style.text_size
• 局部更新不刷屏 — 用 element_id 精确定位
• 打字机效果 — config.streaming_mode
• 自定义颜色 — config.style.color 支持 RGBA

八、官方参考资料

• 卡片 JSON 2.0 结构
• 表格组件
• 分栏组件
• 颜色枚举值
• 卡片构建工具

总结

飞书卡片的门槛比想象中低：核心就三件套（header / body.elements / config）+ 一个 schema: 2.0。别手写，把需求描述清楚丢给智能体，它生成的 JSON 直接可用。真正容易翻车的就那么几个点——忘了 schema、表格位置放错、颜色用非官方值——记住这篇的清单就够了。

下一步可以做的：把日报、告警、排行榜这些高频重复消息全部改成智能体自动发卡片，配合飞书开放平台把「飞书 SDK 使用避坑」里的接入经验用起来。

相关文章：

• 飞书 SDK 使用避坑指南：从 TenantAccessToken 到事件订阅的 20 个问题
• Hermes Agent 升级后飞书机器人无响应：根因与修复
• 2026 上半年 AI 工具盘点：哪些真正值得用