Betaflight CLI 命令行新手教程

CLI = Command Line Interface，命令行界面。很多飞控高级设置、参数备份、固件微调都在这里操作，新手不用害怕，只复制粘贴指令，不要乱输陌生代码。

 一、进入 CLI 界面方法

1. USB 连接飞控，打开 Betaflight 地面站

2. 左侧菜单栏拉到最底部，点击【CLI】

3. 下方白色输入框就是命令输入位置，输入命令后按回车执行

 ⚠️重要：执行完修改类命令，最后一定要输入 `save` 回车保存，不保存重启飞控就失效！

 二、基础常用指令（新手高频）

 操作示范：备份你的飞机参数

1. CLI 输入框输入 `diff` → 回车

2. 等待文字全部加载完成

3. 鼠标全选窗口内所有文字，复制，粘贴到记事本保存。

  以后炸机换飞控，直接把这段文字粘贴进 CLI，输入`save`，一键恢复全部调参。

操作示范：恢复出厂设置

1. CLI 输入：`defaults`，回车

2. 等待执行完成

3. 输入 `save`，飞控重启，所有参数回到固件默认。

 ⚠️恢复出厂后：端口、电机转向、PID、Rates 全部清空，需要重新调试。

三、新手常用调参类 CLI 指令（举例）

类参数在地面站图形界面找不到，只能 CLI 修改

1. 关闭电机怠速（防止解锁就转）

set motor_idle = 0 

save

2.修改黑匣子记录速率示例

set blackbox_rate = 1000

save

每一条 set 指令写完，最后都要`save`保存。

四、新手必守安全规则

1. **不要在装桨状态下执行 CLI、电机相关命令！务必拆下桨叶！**

2. 不认识的命令不要网上随便复制粘贴，部分指令会损坏配置。

3. 粘贴代码的时候，不要多带多余空行，容易报错。

4. 如果输入命令提示`Invalid command` = 命令拼写错误，检查字母。

5. CLI 里参数区分下划线，比如`motor_idle`不能写成`motor idle`。

 五、常见问题排查

1. 粘贴代码没反应：

看输入框是否激活；代码里多余换行符号，分段粘贴。

2. 执行 save 飞控断开连接：正常现象，保存会自动重启飞控，等待重连即可。

3. 想放弃本次修改，不想保存：直接关闭 CLI 页面，不输入 save，改动不会生效。

六、CLI 使用场景总结（什么时候才需要打开 CLI）

✅ 备份 / 分享飞机调参（diff）

✅ 清除黑匣子日志

✅ 恢复出厂参数

✅ 修改地面站界面没有的隐藏参数

❌ 普通新手日常调参（PID、Rates、OSD、端口）完全不需要 CLI，图形界面足够。