教程⑧ 疑难杂症与性能优化

用 Acode 一段时间后，你可能会遇到终端异常、性能下降、与 Termux 如何共存等问题。这篇手册汇总高频疑难杂症与对应解法，建议收藏备用。

终端环境损坏怎么办

误操作导致终端环境损坏时，最快的方式是在设置中删除终端文件系统，重新初始化 Alpine。删除前务必先备份：导出备份文件到本地或云盘，恢复时选择备份文件，几分钟内环境就能还原。

如何与 Termux 共存互通

很多用户之前使用 Termux，不想迁移已有环境。安装 AcodeX 插件即可让 Acode 连接 Termux，复用已有的工具链与软件包。安装后在插件设置中指定 Termux 路径，终端标签里选择 Termux 会话。两者各司其职：Acode 负责编辑，Termux 负责已有环境。

大文件卡顿的优化

打开超大文件时编辑器可能卡顿。优化方法有三：关闭语法高亮或降低高亮级别；关闭不必要的插件；把超过五万行的文件按模块拆分。Acode 对普通项目完全够用，极端大文件建议用专门工具处理。

电池与发热管理

长时间运行终端编译或 AI 代理时，手机发热属正常现象。建议开启飞行模式加 Wi-Fi 降低耗电，关闭后台应用，并降低屏幕亮度。连接电源时选择慢充模式，减少电池损耗。编译任务频繁的话，也可以把重活放到云服务器。

常见报错速查

apk 安装失败：先执行 apk update 刷新源。连接服务器超时：检查安全组端口。中文乱码：设置 LANG=C.UTF-8 并更换终端字体。命令找不到：确认软件包已安装，或在设置中重置 PATH。克隆仓库权限拒绝：确认已在设置中登录 GitHub。

防止误删项目

Acode 删除文件是直接移除，没有回收站。关键操作前建议先用 Git 提交，或把重要项目推送到远程仓库，即使手机丢失也不会失去代码。定期执行 apk cache clean 清理终端缓存，也能释放空间。