关键要点

  • 终端文件在应用私有目录 Android/data/com.foxdebug.acodefree/files/public,卸载 App 会一起消失;项目源码在你通过「添加路径」授权的手机目录,这部分才需要备份。
  • 终端 /home、/root、/public 指向同一份文件(2026 年官方 PR #2049 合并绑定),和文件浏览器的 Public 文件夹完全一致。
  • 不用 root 也能导出:系统文件选择器里能找到 Acode / Terminal Public 存储位置,直接复制到云盘;或设置 → 终端设置 → 备份一键打包。
  • 中文乱码分两种:老文件 GBK 编码用 python3 -c 转成 UTF-8;终端显示乱码用 export LANG=C.UTF-8,并写进 /initrc 永久生效。
  • Android 10+ 只能添加子目录,不能添加整个存储根目录。
01

先分清两类文件

第一类是终端文件系统,存在 Acode 应用私有目录里,终端里的 /home、/root、/public 都指向它,卸载 App 会一起消失。第二类是编辑器项目文件,来自你通过「添加路径」授权的手机目录,或 FTP/SFTP 添加的远程目录——真正需要备份的是这部分源码。官方终端文档明确:Home 目录(/home)和 Public 文件夹始终可访问;整个内部存储需要「所有文件访问」权限,且 Play 版不支持。

02

终端里的文件在安卓设备什么位置

Acode 终端文件系统的宿主目录是应用私有数据目录下的 public 文件夹,大致在 Android/data/com.foxdebug.acodefree/files/public(具体随版本变化)。它不是 /sdcard,普通文件管理器默认看不到。2026 年官方通过 PR #2049 把 /home、/root、/public 合并绑定到同一个 public 目录,所以你在终端根目录创建的文件,和在 Public 文件夹里看到的是同一份。

想把它导出来,不用 root:Acode 注册了 DocumentsProvider,在安卓系统文件选择器里能找到名为 Acode / Terminal Public 的存储位置,直接复制内容到 Download 或云盘。官方讨论区(Acode#2920)特别提醒:卸载 App 会删除这个目录,务必先复制出来。更省事的备份是 设置 → 终端设置 → 备份,导出的备份文件是压缩包,换机时在终端设置里选择备份文件即可恢复整个环境(含已装软件包)。

03

手机里的项目文件在哪里

Acode 没有强制把所有项目塞进一个「Acode 文件夹」,而是让你自己选目录。授权后,该目录出现在文件浏览器的侧栏,点「打开」设为活动工作区,之后每次进入 Acode 都能快速切换。官方文件浏览器指南对目录授权、导入项目有更完整的说明。

在文件夹里点 + 可以新建文件、文件夹、项目(内置模板),也可以「导入项目」直接解压 zip。长按文件或文件夹,能重命名、删除、查看属性(大小、权限、完整路径)、用其他应用打开、复制 URI。

Acode 的欢迎页会列出最近项目,点击即可打开,也可以从欢迎页直接新建项目——新建时引导你选择存放目录,这一步本质就是在添加路径。把「最近项目」当快捷入口,比每次手动导航快很多。

导出项目没有一键打包按钮(官方未提供项目导出为 zip 的功能),最简单的做法是系统文件管理器里把整个目录复制到云盘或电脑。

04

添加路径的完整步骤(Android 10+)

  1. 打开文件浏览器,先点顶部路径回到根目录 /。
  2. 点右上角 +,选择「添加路径」。
  3. 系统弹出 SAF 选择器,如果看不到内部存储,点右上角三个点菜单,勾选「显示内部存储」。
  4. 选到你的项目目录(比如 Documents/code),点右下角 ✔ 确认。
  5. 给路径起个名字,侧栏就会出现这个目录,之后长按可重命名或移除。

注意:Android 10+ 只能添加子目录,不能添加整个存储根目录或 SD 卡根目录。官方 FAQ 也确认了这一点。

05

acode 如何写中文注释:乱码怎么解决

Acode 保存文件默认 UTF-8,所以新写的中文注释在编辑器和终端里都正常。乱码通常发生在两种情况:

情况一:打开老文件(GBK 等非 UTF-8 编码)。Acode 目前没有图形化的编码切换选项(官方未明确说明是否支持界面级转码),最稳的办法是用终端转码。装了 Python 后一行搞定:

terminal
python3 -c "open('new.c','w',encoding='utf-8').write(open('old.c',encoding='gbk').read())"

把 old.c 换成你的文件名,转码后再用 Acode 打开就是正常中文。想先确认文件编码,终端里执行 file 文件名,输出会标明编码。

情况二:终端里显示乱码。多半是 locale 或终端字体问题。执行 export LANG=C.UTF-8 临时生效;想每次打开终端都生效,把这行写进 /initrc。终端设置里再换一个支持中文的字体即可。

写代码本身不用操心编码:Python 3 源码默认 UTF-8,文件头不必再写 coding 声明;C/C++ 源码里写中文注释,GCC 默认按 UTF-8 处理输入,只要文件保存为 UTF-8 就正常。

文件路径和编码都理顺了,下一步就是把代码跑起来——看 Acode 怎么运行代码,C/JS/Python 三条命令实测。

06

文件管理实用技巧

  • 终端与编辑器无缝切换:终端里 acode . 打开当前文件夹,acode 文件名 直接在编辑器打开文件。
  • 活动工作区:把常用项目目录设为活动工作区,侧栏随时切换,不用每次重新导航。
  • 备份三件套:源码推 Git 远程仓库;终端环境用设置里的备份导出;public 目录定期复制到云盘。
  • 大文件:超过几万行的文件编辑会变卡,建议拆文件,或用 QuickEdit 这类轻量编辑器应急(见 安卓代码编辑器对比)。
  • 查看隐藏文件:文件浏览器菜单里可设置显示隐藏文件,配合查看 .gitignore、.env 等配置更方便。
07

常见问题速答

  • 换手机后文件还在吗?手机存储里授权过的项目文件还在;终端私有目录会随卸载删除,需要用备份文件恢复。
  • 为什么文件管理器看不到我的项目?因为项目在你授权的任意目录,不在固定的 Acode 文件夹;到授权路径里找。
  • 终端里能直接访问 /sdcard 吗?需要「所有文件访问」权限(Android 10+,非 Play 版);没有权限就通过文件浏览器的添加路径中转,想用完整权限可以装 F-Droid 版。
  • 能打开云盘或远程文件吗?FTP/SFTP 可以在文件浏览器里添加连接;Google Drive、Dropbox 这类云盘依赖系统 SAF 选择器,或把文件下载到本地再打开。
  • 误删文件能恢复吗?Acode 删除是直接移除,没有回收站;重要文件务必用 Git 或云盘备份。
08

备份是最后一道保险

还没装 Acode?下载页 有官方安装包。装好后把终端备份和 Git 提交养成习惯,文件就丢不了。