常见问题（FAQ）
安装和配置
Q: 如何安装 Ace Code Editor 插件？
A: 有三种安装方式：
社区插件商店（推荐）：
- 打开 Obsidian 设置 → 社区插件
- 搜索 "Ace Code Editor"
- 点击安装并启用
手动安装：
- 从 GitHub Releases 下载
- 解压到
.obsidian/plugins/ace-code-editor/目录 - 重启 Obsidian 并启用插件
BRAT 安装：
- 安装 BRAT 插件
- 添加
RavenHogWarts/obsidian-ace-code-editor
Q: 插件安装后无法启用怎么办？
A: 请检查以下几点：
- 确保 Obsidian 版本兼容（建议 v1.8.0+）
- 检查插件文件是否完整
- 查看控制台是否有错误信息
- 尝试重启 Obsidian
- 禁用其他可能冲突的插件
使用问题
Q: 编辑的文件会自动保存吗？
A: 是的，插件支持自动保存功能：
- 编辑器内容变化会触发自动保存
- 也可以手动保存（Ctrl/Cmd + S）
功能相关
Q: 代码补全功能如何使用？
A: 代码补全会自动触发：
- 输入时自动显示建议
- 使用 Tab 键接受建议
- 使用方向键选择不同建议
- Esc 键取消补全
Q: 如何使用搜索和替换功能？
A:
- 查找：Ctrl/Cmd + F
- 替换：Ctrl/Cmd + H
- 查找下一个：F3
- 查找上一个：Shift + F3
- 跳转到行：Ctrl/Cmd + G
兼容性问题
Q: 与其他插件冲突怎么办？
A: 解决冲突的步骤：
- 确定冲突的插件
- 检查快捷键是否重复
- 调整插件加载顺序
- 联系开发者报告兼容性问题
Q: 在移动设备上能使用吗？
A: 目前插件主要针对桌面版 Obsidian 优化，移动端支持有限：
- 基本编辑功能可用
- 某些快捷键可能不可用
- 触摸操作体验可能不佳
故障排除
Q: 编辑器无法打开文件？
A: 检查以下问题：
- 文件是否存在且可读
- 文件编码是否支持
- 是否有权限访问文件
- 查看控制台错误信息
Q: 语法高亮不正确？
A: 可能的解决方案：
- 确认文件扩展名正确
- 检查文件内容格式
- 重新加载编辑器
Q: 快捷键不响应？
A: 故障排除步骤：
- 确认编辑器处于焦点状态
- 检查快捷键配置
- 查看是否与其他程序冲突
- 重启 Obsidian
- 重置快捷键设置
Q: 插件更新后出现问题？
A: 更新后的问题处理：
- 清除插件缓存
- 重置插件设置
- 检查更新日志中的破坏性更改
- 如有必要，回退到之前版本
- 向开发者报告问题
获取更多帮助
如果以上答案没有解决你的问题：
- 搜索现有问题：在 GitHub Issues 中搜索
- 提交新问题：详细描述问题和重现步骤
- 参与讨论：在 GitHub Discussions 中讨论
- 查看文档：阅读完整的使用文档
如果你有其他问题或建议，欢迎通过 GitHub 联系我们！