故障排除

设备连接问题

USB 设备无法识别

1. 确认 USB 线支持数据传输（非纯充电线）
2. 检查设备管理器（Windows）或 /dev/tty*（Linux/macOS）是否显示串口
3. 尝试更换 USB 端口或线缆
4. Android：确认已授予 USB Host 权限

串口连接失败

1. 确认波特率设置正确（默认 115200）
2. 确认没有其他程序占用串口
3. 尝试断开后重新连接
4. 检查设备是否处于 REPL 状态

连接后无响应

1. 按 Ctrl+C 中断当前程序
2. 按 Ctrl+D 软重启设备
3. 断开并重新连接
4. 尝试降低波特率

文件操作问题

上传失败

1. 确认设备处于 REPL 状态
2. 检查设备存储空间
3. 确认文件路径有效
4. 尝试先中断设备上运行的程序

文件同步冲突

1. 使用"查看差异"对比文件内容
2. 选择覆盖或保留本地版本
3. 手动合并后重新上传

编辑器问题

语法高亮不显示

1. 确认文件类型被正确识别
2. 尝试切换编辑器主题
3. 重启 IDE

LSP 补全不工作

1. 检查设置 → 语言服务器是否启用
2. 确认 LSP 进程路径正确
3. 查看 LSP 状态（状态栏显示）
4. 尝试重启 LSP

Git 问题

Git 仓库未检测

1. 确认项目目录包含 .git 文件夹
2. 点击"重新检测"
3. 如未初始化，点击"初始化 Git 仓库"

推送失败

1. 检查网络连接
2. 确认远程仓库地址正确
3. 检查凭据配置
4. 尝试先拉取再推送

插件问题

插件安装失败

1. 确认 ZIP 文件格式正确
2. 检查 plugin.toml 配置
3. 查看插件页面的错误信息

插件不显示

1. 确认插件类型和平台支持
2. 检查插件是否被禁用
3. 尝试重启插件

性能问题

编辑器卡顿

1. 关闭不需要的标签页
2. 禁用本地补全（大文件时）
3. 减小编辑器字号
4. 关闭代码折叠或缩进参考线

启动缓慢

1. 减少已安装插件数量
2. 清理缓存目录
3. 检查磁盘空间

获取帮助

如以上方法无法解决问题：

1. 进入关于页面
2. 点击"复制诊断信息"
3. 在 GitHub Issues 提交问题
4. 粘贴诊断信息