Acode 安装不复杂，但第一次打开时有几个关键选择会影响后续体验。这篇教程带你完成安装、初始化和第一个项目。
国内用户最稳妥的方式是从 GitHub Releases 下载 APK，按提示允许安装未知应用即可。能访问 Google Play 的话，商店版更新最及时；F-Droid 免费无广告但审核较慢。
打开 Acode 后先处理三件事：允许访问存储空间；调好主题；点击底部终端图标下载 Alpine Linux 环境。约一分钟后，你就拥有一个真正的 Linux 终端。
回到主界面，点击左上角菜单新建项目，输入名称 my-app。进入目录后点击右下角加号新建文件 index.html，填入下面的内容：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>我的第一个页面</title>
</head>
<body>
<h1>你好，Acode！</h1>
</body>
</html>保存后点击右上角预览图标，内置浏览器就会打开页面。预览支持热更新，修改代码后刷新即可看到变化。
按 Ctrl+Shift+P 打开命令面板，输入关键词即可执行新建文件、打开终端、格式化代码等操作。外接键盘时这个快捷键和电脑一致。
APK 安装失败时，先检查是否已允许安装未知应用，入口一般在安全中心或应用管理里。存储空间不足也会导致失败：终端环境约需 300MB，建议预留至少 500MB。遇到解析包错误，重新下载一次往往就能解决。
上一篇跑通了最小页面，这一篇我们用 Acode 完成一个带样式和交互的完整前端项目，并学会用 Node.js 在手机上启动本地服务器。
标准前端项目包含三个文件：index.html 负责结构，style.css 负责样式，app.js 负责交互。在 Acode 中新建项目 my-site 并依次创建这三个文件，侧边栏的文件树支持长按重命名、复制和删除。
在 index.html 中引入 style.css 和 app.js。样式文件定义配色与卡片布局，脚本文件里写一个按钮交互：点击后改变文字内容并记录点击次数。Acode 对 CSS 和 JavaScript 都有语法高亮，写错括号时行号附近会立即出现错误标记。
点击预览图标，页面会在内置浏览器中渲染。预览工具栏里的设备模拟可以切换到手机、平板等不同尺寸，检查响应式布局是否正常，相当于把浏览器开发者工具装进了口袋。
纯静态页面可以直接预览，但现代前端依赖模块加载或接口请求，这时需要本地服务器。打开终端，输入以下命令：
cd my-site
npm init -y
npm install express
node server.js提前在 server.js 中写好静态资源托管代码，启动后访问 http://localhost:3000，就能以服务器模式访问你的项目。
确保手机与电脑连接同一 Wi-Fi，在终端查看手机局域网 IP，用电脑访问 http://手机IP:3000 即可。
Acode 内置基础代码补全，想要更智能的补全可以安装 LSP 插件接入 TypeScript 或 CSS 语言服务器，但手机内存有限，大型语言服务器可能消耗较多资源。预览空白多半是标签未闭合或引号不匹配，检查控制台输出可以快速定位。
Acode 的终端是一个通过 proot 运行的完整 Alpine Linux 环境，掌握它，手机就是随身 Linux 开发机。
Alpine 是极简 Linux 发行版，包管理器为 apk，软件都通过它安装，如 Python 与 Node.js：
apk update
apk add python3 py3-pip nodejs npm git
python3 --version
node -v需要编译 C 程序或安装需要编译的 Python 包时，安装 assemble-base 工具链：
apk add assemble-base
gcc --version之后即可编译 C 代码，也能用 pip 装 pandas、numpy 等库（安装较久建议连电源）。
用 Python 开发建议创建虚拟环境避免包冲突，执行 python3 -m venv venv 然后激活：
cd 项目目录
python3 -m venv venv
source venv/bin/activate
pip install flask激活后命令行前缀会出现 (venv)，安装的包只属于当前项目。
Acode 支持多终端标签，可重命名、换色，同时跑服务器与 Git 命令；还能更换默认 shell，如 bash 或 zsh。
整个 Alpine 环境（含软件包与项目文件）可在设置中一键备份，换手机后恢复即完整迁移。
npm 可装全局工具，如 nodemon、typescript。安装慢可换国内镜像：npm config set registry https://registry.npmmirror.com。
Alpine 环境有独立目录结构，项目文件可放 root、home 或手机共享目录，推荐放共享目录。pwd、ls、cd 与电脑 Linux 一致。
手机写代码不只在本地。Acode 内置 SFTP/FTP 管理器与 SSH 终端，可以远程连接电脑或云服务器，随时随地改代码、部署网站。
连接服务器需要三样东西：IP 地址或域名、端口号、账号密码。FTP 默认使用 21 端口，SFTP 和 SSH 默认使用 22 端口。使用云厂商服务器时，记得在安全组里放行对应端口。
打开 Acode 侧边栏，切换到远程（Remote）标签，点击添加连接，选择 SFTP 协议，填写主机地址、端口、用户名和密码，保存后点击连接。成功后就能看到服务器目录树，像浏览本地文件一样上传、下载、重命名、删除远程文件。
重启服务、查看日志这类操作需要命令行。Acode 的 SSH 终端可以登录服务器执行任意命令：打开终端标签，选择 SSH 会话，输入服务器地址和凭证即可。登录后就能执行 apt 更新、systemctl 管理服务、tail 查看日志等操作。
频繁输入密码很麻烦，建议配置 SSH 密钥。在终端生成密钥对，把公钥追加到服务器的 authorized_keys 文件中，之后连接时选择密钥认证即可免密登录。
用 Acode 写好静态网站后，先在本地构建项目，再打开 SFTP 连接把构建产物上传到服务器网站根目录，最后用 SSH 终端重载 Web 服务。整个过程全部在手机上完成。
不要在公共网络中使用明文 FTP，尽量选用 SFTP。密码不要明文保存在笔记里，可以使用 Acode 内置的凭证存储或密码管理器。配置密钥登录后建议关闭密码登录。
连接超时最常见。先确认服务器地址拼写正确，再检查端口是否被防火墙拦截，云服务器需在控制台安全组放行端口。SFTP 能连但上传很慢时，可以切换为 FTP 或压缩大文件后再传。
很多人以为 Git 操作必须在电脑上完成，其实 Acode 内置了完整的 Git 客户端，配合 GitHub 登录，你可以用手机克隆仓库、提交代码、参与开源项目。
在终端中先配置用户信息：
git config --global user.name "你的名字"
git config --global user.email "you@example.com" 然后在 Acode 设置中登录 GitHub 账号，克隆私有仓库和推送代码时无需反复输入凭证。
在欢迎页或侧边栏选择从 Git 克隆，粘贴仓库地址即可，也可在终端手动执行 git clone。打开仓库后，编辑器左侧会显示文件变更数量。
修改代码后，打开 Git 面板勾选要提交的文件，填写提交信息并点击提交按钮完成本地提交；点击推送按钮，代码就同步到远程仓库。
参与开源项目的标准做法是新建功能分支，完成后提交 Pull Request。Acode 中新建、切换分支都很直观。合并时切换到目标分支执行合并命令，出现冲突时编辑器会高亮冲突区域，手动保留正确内容后重新提交即可。
路径：在 GitHub 上 Fork 仓库，在 Acode 克隆副本，新建分支完成修改并推送，再回 GitHub 网页创建 Pull Request。合并后你的贡献就进入上游仓库。
本地提交用 git reset 撤销，已推送则用 git revert 创建反向提交。Git 面板的历史记录显示每次提交的信息与哈希值，可执行这些操作。
可以在手机上提交、在电脑上继续开发，通过远程仓库同步。多人协作时每天先拉取最新代码，减少冲突。GitHub 集成还支持浏览 Issue 和创建 Pull Request。
Acode 是少数能在手机上原生运行 AI 编码代理的安卓编辑器，Claude Code、OpenAI Codex、OpenCode 都可在 Alpine 终端安装。
需要 Node.js 18+、API 密钥或订阅账号、稳定网络。先确认 Node 已安装：
node -v
npm -v未安装则执行 apk add nodejs npm。国内访问部分 AI 服务较慢，建议直连。
Anthropic 官方推荐通过 npm 安装 Claude Code：
npm install -g @anthropic-ai/claude-code
claude --version首次运行需登录并绑定 API 密钥，之后在项目目录运行 claude 即可解释代码、生成测试、修复错误，还能执行终端命令。
OpenAI Codex 同样通过 npm 安装：
npm install -g @openai/codex
codex --version配置 API Key 后即可使用，支持全自动模式，可自主修改验证。
偏好开源方案可选 OpenCode：
npm install -g opencode-ai
opencodeOpenCode 可对接 Anthropic、OpenAI、本地模型等后端。
横屏+外接键盘体验更好，项目放 Acode 文件树中方便代理读取代码。执行 acode . 打开当前文件夹，acode app.js 打开具体文件。
Claude Code 适合日常开发与重构，Codex 适合一次性任务，OpenCode 开源可切换模型。
代理需频繁请求远端模型接口，网络不稳易中断；内存有限时关闭其他应用，无响应按 Ctrl+C 中断。
AI 生成的代码也要人工审查，尤其是数据库或权限管理部分。API 密钥放环境变量，别写进代码。
Acode 的插件生态让它从编辑器变成平台。插件本质是 JavaScript 模块，通过官方 API 与编辑器交互。本文带你从零写一个能用的插件。
最小插件包含两个文件：plugin.json 描述元信息，index.js 是主逻辑，目录放在 Acode 插件目录下，也可打包成 zip。
在 Acode 中新建目录 my-plugin，创建 plugin.json：
{
"id": "com.example.hello",
"name": "Hello Acode",
"version": "1.0.0",
"description": "插入问候语",
"main": "index.js"
}id 是唯一标识，建议用反向域名风格避免冲突。
在 index.js 中注册一个命令，点击后向当前编辑器插入文本：
module.exports = {
commands: {
"hello": () => {
editorManager.editor.insert("你好，Acode！
");
}
}
};editorManager 是全局对象，可访问编辑器、文件系统、终端等 API。
开发时无需发布，Acode 支持直接加载本地插件：设置中从本地安装，指向项目目录即可。重启后在命令面板搜索 Hello 运行命令，光标处就会出现问候语。
完成后把目录压缩为 zip，在插件商店网页版或应用内提交元信息并上传，审核通过后所有用户都能安装。每次更新记得同步修改 version 字段。
除了插入文本，插件还能操作文件系统、终端与设置，可实现自定义格式化、批量替换、代码统计等工具。
可在 plugin.json 注册多个命令、定义设置项，发布后关注反馈及时修复。
掌握 plugin.json 与 index.js 就入门了，多读源码、多写命令、多试 API。
用 Acode 一段时间后，你可能会遇到终端异常、性能下降、与 Termux 如何共存等问题。这篇手册汇总高频疑难杂症与对应解法，建议收藏备用。
误操作导致终端环境损坏时，最快的方式是在设置中删除终端文件系统，重新初始化 Alpine。删除前务必先备份：导出备份文件到本地或云盘，恢复时选择备份文件，几分钟内环境就能还原。
很多用户之前使用 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 清理终端缓存，也能释放空间。
在手机上写代码，Acode 主题是除了功能之外最影响体验的部分。默认界面虽然不难看，但看久了、或者白天在户外用，总觉得字号太小、配色刺眼。这篇文章专门讲 Acode 外观设置：怎么换主题、调字体、改代码高亮配色，以及哪些主题免费、哪些要 Pro，一次说清。
用手机写代码经常一坐就是一两个小时，屏幕亮度、环境光线变化都很大。把 Acode 调成适合自己的深色/浅色主题和字号，能直接缓解眼睛疲劳。而且换主题只要几秒钟，花几分钟设置好，后面每次打开都舒服。
Acode 的主题入口在 设置（Settings）→ 主题（Theme），页面顶部有 App、Editor、Terminal 三个标签：
App 主题里，免费版自带 System（跟随系统）、Dark（深色）、Legacy（经典） 等基础主题。选 System 后，Acode 会自动跟随手机系统的深色/浅色模式，晚上手机切深色，Acode 也跟着变。其余内置主题，比如浅色 Light、纯黑 OLED、Glass、Neon、Sunset、Ocean，以及 Obsidian、Ember 等新主题，都属于 Pro 高级主题，列表里带星标，免费用户点击会进入购买引导。Acode Pro 是一次性内购，主要解锁 去广告 + 高级主题，不买也不影响基本使用。
觉得代码字号小，去 设置 → 编辑器设置（Editor Settings）：
想用手机里下载的字体，可以在 设置 → 应用设置 → 外观与输入 → 字体（Fonts） 里添加，之后就能在编辑器字体里选。
代码配色在 设置 → 主题 → Editor 标签里换。Acode 内置 20 多种语法高亮主题，全部免费：One Dark、Dracula、Monokai、Nord、Tokyo Night、VS Code Dark、GitHub Dark/Light、Solarized、Catppuccin 等。选主题时顶部有实时预览，点一下就能看到效果，当前文件立即生效，不用重启。
Acode 没有单独的「夜间模式」开关，护眼靠两招：一是 App 主题选 System 跟随系统深色模式；二是用 OLED 主题（Pro）——背景是纯黑 #000000，在 AMOLED 屏幕上不仅省电，暗光下也更不刺眼。如果不想买 Pro，可以在插件市场装免费的 AMOLED Black 编辑器主题，代码区同样纯黑。
官方不支持直接导入 .json 主题文件。自定义主题有两条官方路子：
Acode 的外观定制就三步：设置 → 主题 换皮肤和代码配色，设置 → 编辑器设置 调字体字号行高，想要更多主题去插件市场装。免费的 System 跟随系统、全套编辑器高亮主题已经够用；追求 OLED 纯黑或自定义配色，再考虑 Pro。
刚上手的朋友先看Acode 快速上手，写前端可以配合前端三件套开发实战，遇到问题到疑难杂症与性能优化找答案，还有疑问翻翻常见问题。还没装 Acode？获取 Acode。
]]>关键要点
Acode 是安卓端的代码编辑器，在手机或平板上改代码比自带文本编辑器顺手得多。它开源免费，这也是下载站盯上它的原因。
官网排在搜索结果第一，从官网进最稳；习惯用商店就选 Google Play 或 F-Droid。GitHub 有源码，适合追新版的用户。
百度搜这个词，官网排第一，但紧跟着就有伪装成官方中文版的下载站混进来。这类站把 App 重新打包，配上「官方版」字样，让人误以为它是官方中文渠道。实际上 Acode 只发布一个国际版，不存在单独的「官方中文版」。
1. 认包名：官方包名 com.foxdebug.acodefree，装好后可核对。
2. 认来源：四个官方来源之外，其他都是第三方。
3. 看标题：出现「官方中文版」「破解版」「去广告版」都要警惕。
4. 查版本号：GitHub Releases 有最新版本，下载站给的一般滞后或魔改。
打开 App 就能建文件写代码。想第一时间收到新版，就关注 GitHub 的 release 或保持商店更新。如果是从第三方下载站装的，先卸载再重装官方版。
---
想直接拿安装包，走本站下载页：本站下载入口。认准 acode.app 和包名 com.foxdebug.acodefree，别让伪中文版占了便宜。
---