dify知识库批量导入需严格遵循格式要求：excel须为.xlsx格式、清除合并单元格等非文本元素、首行英文小写且含content列；csv须utf-8无bom编码、英文小写表头；导入时须手动选择embedding模型并勾选“按段落”自动分割。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想用Excel或CSV把结构化数据批量塞进Dify知识库，却卡在上传失败、内容错乱或中文变问号？不是文件选错了，而是Dify对表头命名、编码、字段结构有硬性要求，一步没对齐，整批数据就废掉。
Excel文件导入前的3个强制准备动作
第一步：确认文件是.xlsx格式，不是.xls或Excel另存为的“兼容模式”。Dify不解析旧版二进制格式，上传后会直接报“文件损坏”。
第二步：删掉所有合并单元格、批注、图表和公式。Dify只读取纯数值和文本，遇到合并单元格会跳过整行，导致数据断层。
第三步：首行必须是英文小写表头，且【必须包含content列】。其他列如title、source、metadata可选，但content是唯一必填字段，缺了就无法生成知识片段。
CSV文件避坑三连击
方法一：用Excel另存为CSV时，务必点“另存为→浏览→工具→Web选项→编码→UTF-8”，否则默认ANSI编码，中文全变乱码。
方法二：用记事本打开刚保存的CSV，第一行看到的是“content,title,metadata”而不是“内容,标题,元数据”，说明表头已按Dify要求转为英文小写。
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
方法三：检查CSV里有没有隐藏的BOM头。如果用Python pandas读取时报错“utf-8 codec can’t decode byte 0xef”，就是BOM惹的祸——换VS Code打开，右下角点编码→“Reopen with Encoding”→选UTF-8无BOM。
导入时关键设置项操作路径
① 进入知识库页面 → 点“导入”按钮 → 选择“本地文件” → 拖入准备好的Excel或CSV文件。
② 文件上传后，弹出配置窗口 → 【Embedding模型必须手动选择，不能留空】，否则后续召回测试永远返回空结果。
③ 勾选“自动分割文档” → 分割方式选“按段落”，不要选“按字符数”，否则长文本会被硬切，语义断裂。
④ 点“保存并处理” → 等待右上角进度条走完，状态变成“已完成”才算真正入库。
