先区分 Wiki 页面、云文档和附件目录，再按数量选择逐篇下载、API 自动化或浏览器扩展批量导出。保存时重点检查目录层级、本地图片和离线可打开，而不是只看导出了多少篇。
飞书知识库里通常混着 Wiki 页面、普通云文档、上传的附件和多层文件夹。单独打开一篇很容易，想把整块内容搬走时，麻烦才出现：不同位置的权限和下载入口并不一样。
飞书官方帮助中心说明过，暂不提供直接导出整个知识库的功能，页面需要分别处理。所以知识库迁移通常是一套组合动作，不会只有一个按钮。
先分清知识库里到底有什么
在开始导出前，先做一张内容清单：
| 内容位置 | 常见内容 | 导出难点 |
|---|---|---|
| Wiki 页面 | 项目文档、规章、长期维护的知识页 | 页面很多，层级需要保留 |
| 云文档 | 普通文档、表格、演示文稿 | 入口分散，格式不同 |
| 云空间文件夹 | 上传的 PDF、图片和附件 | 文档与附件需要分别处理 |
| 外部链接 | 嵌入网页、第三方系统 | 不一定能完整离线保存 |
先确定哪些内容是你要长期保留的个人资料，哪些属于公司或团队资产。只处理你有权限访问并有权保存的内容。
三条常见路线
路线一，逐篇下载
打开文档，从“下载为”菜单选择 Markdown、Word 或 PDF。优点是简单、官方支持；缺点是文档一多就会变成机械劳动，目录层级和图片也要另外整理。
适合十几篇以内，或者只想保留少量关键文件的情况。
路线二，开放平台 API 加命令行
这类方案通常要创建企业自建应用、申请文档和云空间权限，再运行命令行工具。它能进入自动化流程，适合定时备份和大量文档。
它的问题也很明确：需要管理员审核、需要处理密钥、需要会运行终端命令。个人用户如果只是临时迁移，成本往往高于收益。
路线三，浏览器扩展复用当前登录状态
浏览器扩展可以在你打开的飞书网页里读取当前账号有权限访问的页面，不需要另外创建应用，也不需要把文档分享链接改成“互联网可见”。
这种方式的边界是：它只能处理你当前打得开的内容，不能绕过权限，也不能读取只在飞书桌面客户端里出现的页面。
批量导出时最该检查什么
目录层级是否能还原
导出后的文件夹应该能看出原来的知识库层级。否则文档再多，也只是把文件倒进了同一个目录。
图片是否与正文一起保存
只导出 Markdown 文本时，图片可能仍是飞书临时链接。正确的结果应该是图片落到本地目录，Markdown 使用相对路径引用。
链接是否仍然可用
正文里的内部文档链接、附件链接和外部网址要分别检查。离开了原组织或账号后，部分飞书链接会失效，重要内容最好保留本地副本。
导出结果是否能离线打开
把整个输出目录移到另一台电脑，断开网络，随机打开几篇文档。图片、表格和代码块都正常，才可以停止测试。
用浏览器扩展完成一次迁移
- 在浏览器里打开飞书知识库，确认目标页面都能正常阅读。
- 从知识库根目录开始选择要处理的范围。
- 将多篇文档加入导出队列。
- 选择保存位置，并确认图片随文档一起保存。
- 导出完成后按层级抽查目录、图片和正文格式。
几十篇以内手动仍可完成；到了几百篇，批量队列的价值会非常明显。飞书工具箱的 Pro 批量导出适合这个区间，每项付费功能也可以先免费试用三次。
什么情况不适合使用扩展
如果需要每天定时运行、无人值守上传到服务器，或者要把导出接入现有自动化系统，命令行加 API 更合适。
如果企业明确禁止浏览器扩展读取文档页面，也不要强行绕过管理策略。先确认内部规定，再选择合规路径。
迁移做完后，文件夹要看得懂，文档要打得开，图片不能断链，而且你确实有权保留这些内容。四个条件缺一个，导出数量再多也只是半成品。