# 导入导出卡片

飞书卡片搭建工具支持导入卡片的 `.card` 文件和旧版[消息卡片搭建工具](https://open.feishu.cn/tool/cardbuilder?from=open_docs)导出的 `.json` 文件，并支持导出卡片的 `.card` 文件，从而实现跨企业、跨工具同步卡片数据。`.card` 源文件文件包含卡片变量和卡片样式内容。本文档介绍如何在搭建工具中导入与导出卡片。

## 导出卡片

飞书卡片搭建工具仅支持导出 `*.card` 文件。你可以在[飞书卡片搭建工具](https://open.feishu.cn/cardkit?from=open_docs_import_and_export)目标卡片编辑页面的右上角，点击 **…** > **导出卡片**。卡片将下载到系统默认下载路径。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/4f97da695ede696072c88480bd8ff0d4_zac2TzzJPh.png?height=465&lazyload=true&maxWidth=500&width=2430)

若要查看卡片的 JSON 源码，在卡片编辑页面下方点击 **卡片源代码** 右侧的图标即可。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/337c4fa1a3ed5d2719e0bb9dc2e38314_Pk1LKHStAX.gif?height=898&lazyload=true&maxWidth=500&width=1366)

## 导入卡片

飞书卡片搭建工具支持导入 `*.card` 文件和旧版[消息卡片搭建工具](https://open.feishu.cn/tool/cardbuilder?from=open_docs)导出的 `*.json` 文件。

### 注意事项 

- 从旧版[消息卡片搭建工具](https://open.feishu.cn/tool/cardbuilder?from=open_docs)中导出 `*.json` 文件时，你必须点击 **导出卡片** 获取 JSON 文件（仅卡片所有者有权限导出）。直接复制卡片 JSON 的方式将导致卡片导入失败。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/e115bd2d3b73bcc2ac92375339777582_ULAwdaB0eV.png?height=791&lazyload=true&maxWidth=500&width=1920)

- 将旧版工具导出的 `*.json` 文件导入至新版工具时，请注意：
  - 若旧版工具中有变量占位符，你需确保你已在旧版工具中声明了变量。即你需要在旧版工具中 **创建变量** 并添加 **模拟数据**。否则变量在新版工具中将失效。
  - 若旧版工具中有「循环对象」变量，你需确保你已在「循环对象」的模拟数据中填充了子变量数据，否则绑定了「循环对象」的分栏将在新版工具中渲染异常。新版工具会将旧版工具的「循环对象」变量转换为「对象数组」变量，并根据旧版工具模拟数据中声明的 `key-value` 创建相应类型的子变量。

### 操作步骤

1. 在 **我的卡片** 页面或卡片编辑页面，点击 **导入卡片**，传入 JSON 文件。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/cad3130d0d8d1ac62db29af07d767e63_IbOxqqLh7x.png?height=554&lazyload=true&maxWidth=500&width=1593)

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/ca6de86ee0d9589a73174c29d6327279_egi0cJAR7u.png?height=954&lazyload=true&maxWidth=500&width=1772)

2. 在卡片编辑页面导入卡片时，你可选择直接覆盖当前编辑中的卡片或新建卡片。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/e534a3a6bba9fd5448c666b7b84bb2ab_otU804HhqJ.png?height=778&lazyload=true&maxWidth=300&width=785)

3. 新导入的卡片与旧版搭建工具中的卡片 ID 不同。要使用新导入的卡片，你需在新版卡片搭建工具中重新获取卡片模板 ID。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/b42c3b02a5a08f70946c28579c738691_ulBs1WiXVr.png?height=360&lazyload=true&maxWidth=500&width=1611)