想用Excel或CSV批量导入结构化数据到Dify知识库，却频繁遇到上传失败、内容错乱、中文乱码问题？问题不出在文件本身，而是Dify对表头命名、编码格式、字段结构有严格规范，只要一步没对齐，整批数据就会报废。先明确几个必须遵守的核心要点：Excel文件必须是.xlsx格式，清除所有合并单元格这类“非文本杂质”，首行必须使用英文小写且必须包含名为content的列；CSV文件则需采用UTF-8无BOM编码，表头同样要求英文小写。导入时务必手动选择Embedding模型，并勾选“按段落”自动分割——这些细节缺一不可。

Excel文件导入前的3个强制准备动作

第一步：确保文件格式为.xlsx，而非旧版.xls或Excel另存为的“兼容模式”。Dify完全不支持旧版二进制格式，上传后直接提示“文件损坏”，导致所有准备工作白费。

第二步：清除所有合并单元格、批注、图表和公式。Dify仅识别纯数值和文本，遇到合并单元格时会跳过整行，造成数据断层——你的内容可能莫名其妙缺失一段。

第三步：首行必须使用英文小写表头，且【必须包含content列】。其他列如title、source、metadata可根据需要添加，但content是唯一必填字段，缺少它将无法生成知识片段，导入操作等于无效。

CSV文件避坑三连击

方法一：用Excel另存为CSV时，务必按“另存为→浏览→工具→Web选项→编码→UTF-8”这一路径操作，否则默认采用ANSI编码，中文内容会全部变成问号，数据直接损坏。

方法二：另存后，用记事本打开CSV文件，第一行应该是“content,title,metadata”这类英文小写表头，而不是“内容,标题,元数据”。如果看到中文表头，说明格式未对齐，Dify无法识别。

方法三：检查CSV文件是否包含隐藏的BOM头。例如用Python pandas读取时报错“utf-8 codec can’t decode byte 0xef”，就是BOM在干扰。解决方法是：用VS Code打开文件，点击右下角编码→“Reopen with Encoding”→选择UTF-8无BOM，保存后重新操作。

导入时关键设置项操作路径

① 进入知识库页面 → 点击“导入”按钮 → 选择“本地文件” → 将准备好的Excel或CSV文件拖入。

② 文件上传后，弹出配置窗口 → 【Embedding模型必须手动选择，不能留空】，否则后续召回测试永远返回空结果——这一步很多人会忽略，踩坑率极高。

③ 勾选“自动分割文档” → 分割方式选择“按段落”，切勿选择“按字符数”，否则长文本会被硬性切割，导致语义断裂，召回效果大打折扣。

④ 点击“保存并处理” → 等待右上角进度条走完，状态变为“已完成”才算真正入库。如果卡在“处理中”超过5分钟，建议检查文件格式和编码是否正确。