如何导出 CLI Dump
学习如何导出飞控的 CLI 配置文件用于分析
为什么需要导出 CLI Dump？
CLI Dump 是飞控配置的完整快照。它包含所有设置,包括 PID 值、滤波器配置、Rate 曲线、电机映射等。拥有 CLI dump 可以让你:
- 在修改前备份配置
- 出问题时快速恢复设置
- 与他人分享配置或从社区获取帮助
- 让 AI 分析你的设置并提供改进建议
本教程将教你如何在几分钟内导出 CLI dump。
准备工作
所需软件
下载并安装 Betaflight Configurator（官方配置工具）
访问 betaflight.com 下载最新版本
连接要求
- 准备一根 USB 数据线（Micro-USB 或 USB-C）
- 确保已安装正确的 USB 驱动程序
- 飞控可以通过 USB 或电池供电
什么是 CLI Dump？
CLI Dump 是飞控的完整配置导出，包含所有设置参数、PID 值、滤波器配置等。这个文件可以用于备份配置或让 AI 分析你的设置。
连接飞控到 Betaflight Configurator
使用 USB 线将飞控连接到电脑，打开 Betaflight Configurator 并点击连接按钮。
进入 CLI 标签
在 Betaflight Configurator 中，点击左侧菜单的 CLI 标签。
执行 dump 命令
在 CLI 命令行中输入以下命令并按回车：
dump等待命令执行完成，通常需要几秒钟。
保存输出到文件
将 CLI 输出保存为文本文件：
- 全选 CLI 输出内容（Ctrl+A 或 Cmd+A）
- 复制内容（Ctrl+C 或 Cmd+C）
- 粘贴到文本编辑器并保存为 .txt 文件
提示： 建议使用有意义的文件名，如 JHEF745V2_20260113.txt，包含飞控型号和日期。
最佳实践建议
定期备份配置
- 备份频率：每次修改重要设置后都应导出 CLI dump 作为备份
- 命名规范：使用日期和版本号命名，如 "config_v2.3_20260113.txt"
- 存储位置：建议保存在云盘或多个位置，避免数据丢失
记录配置变更
- 变更说明：在文件开头添加注释，说明本次修改的内容和原因
- 版本对比：保留多个版本的配置，方便对比和回滚
- 测试记录：记录每个配置版本的飞行表现，便于优化
分享配置
- 社区交流：可以将配置分享到 FPV 社区，获取其他飞手的建议
- 隐私保护：分享前检查是否包含敏感信息（如 GPS 坐标）
- 格式整理：使用文本编辑器整理格式，提高可读性
下一步
成功导出 CLI dump 后，你可以：
对比不同配置
使用文本对比工具（如 WinMerge）对比不同版本的配置差异
推荐工具 →恢复配置
如果调参出现问题，可以使用备份的 CLI dump 快速恢复到之前的状态
查看恢复教程 →常见问题解答
CLI 命令无响应怎么办？
首先确保飞控已正确连接到电脑，USB 线接触良好。如果仍无响应，尝试以下步骤：1) 断开并重新连接飞控；2) 重启 Betaflight Configurator；3) 更换 USB 端口或数据线；4) 检查驱动程序是否正确安装。
dump 输出不完整？
dump 命令需要几秒钟才能完全执行完毕，请耐心等待直到看到命令提示符再次出现。如果输出中断，可能是 USB 连接不稳定，尝试使用质量更好的数据线。确保在命令执行过程中不要操作飞控或移动 USB 线。
可以直接在 CLI 中保存吗？
Betaflight Configurator 10.8.0 及以上版本支持 "保存到文件" 按钮，可以直接将 CLI 输出保存为文本文件，无需手动复制粘贴。如果你的版本较旧，建议升级到最新版本以获得更好的体验。
如何恢复 CLI dump 配置？
恢复配置很简单：1) 连接飞控并进入 CLI 标签；2) 打开保存的 CLI dump 文件；3) 复制所有内容（跳过注释行）；4) 粘贴到 CLI 命令行；5) 输入 "save" 保存设置。注意：恢复前建议先备份当前配置。
CLI dump 包含哪些信息？
CLI dump 包含飞控的完整配置，包括：PID 参数、滤波器设置、Rate 曲线、电机映射、接收机配置、OSD 设置、模式开关等。基本上所有在 Betaflight Configurator 中可以设置的参数都会被导出。
不同固件版本的 dump 兼容吗？
不同版本的 Betaflight 可能有参数变化，直接恢复旧版本的 dump 可能导致部分设置无效或错误。建议在升级固件后重新配置，或使用 diff 命令只导出与默认值不同的设置，这样兼容性更好。