关键要点
- Acode 运行代码有两条路:在 Alpine 终端里手动执行命令,或装 Runner 插件点播放键一键运行。
- JavaScript 用
apk add nodejs npm装运行时;Python 用apk add python3 py3-pip;C 语言要装gcc musl-dev,只装 gcc 会报stdio.h缺失。- 终端默认工作目录 /home 和文件浏览器的 Public 文件夹是同一位置,项目放这里,终端里
cd就能访问。- Runner 插件支持 Python、C、C++、Java、Go、PHP、Ruby、Rust、Lua、Dart、Shell,安装前必须先配置好内置终端,否则播放按钮不出现。
- 边界:proot 跑不了图形程序;Play 版没有「所有文件访问」权限(Android 10+ 非 Play 版才有)。
先搞清 Acode 如何运行代码:两条路
Acode 原生没有电脑 IDE 那种全局「Run」按钮,运行代码靠两条路。第一条:打开内置 Alpine 终端,cd 到文件所在目录,手动执行 node、python3、gcc 等命令,最通用,什么语言都能跑。第二条:安装 Runner 插件,编辑器上方出现播放键,点一下自动在终端里执行当前文件,适合日常快速试代码。
两条路共用同一个前提:终端里先装好对应运行时。Acode 的终端用 proot 在用户空间运行完整 Alpine Linux,不需要 root,首次初始化约 60 秒。还没装好的,按 快速上手 或 Alpine 终端教程 先备齐环境。
运行 JavaScript(.js)
Node.js 是 Acode 最常用的运行时,前端工程、脚本、本地服务器都靠它。在终端执行:
apk add nodejs npm
node -v
cd ~/projects/my-app
node app.js有 package.json 的项目,先 npm install 装依赖,再用 npm run 脚本名 启动。比如一个 Vite 前端项目,npm run dev 就会在手机本地起开发服务器;想要临时预览静态页面,npx serve dist 也能顶一下。如果脚本用了 ES Module 语法(import/export)而报错,检查 package.json 里是否加了 "type": "module",或把文件后缀改成 .mjs——这是手机端最容易踩的坑之一。
写前端时还有更快的路径:HTML 实时预览和内置 JavaScript 控制台都不依赖终端。控制台适合练语法、验证小片段,预览则适合看页面效果,这些和「运行完整脚本文件」互补。
运行 Python(.py)
Alpine 的软件源里有 Python 3,一条命令装好解释器和 pip:
apk add python3 py3-pip
python3 --version
cd ~/projects/my-python
python3 main.py第三方库用 python3 -m pip install 包名 安装。跑爬虫、写脚本、做数据处理,手机上的 Python 和电脑上的行为基本一致;python3 -m http.server 8000 还能一键把当前目录变成局域网可访问的静态服务器。
如果只想快速试一段 Python,不想碰终端,可以装官方 Python 插件(acode.plugin.python):它通过 Pyodide 在应用内直接运行 Python 3.14,打开 .py 文件就能跑,不依赖终端环境。
运行 C 语言(.c):gcc 编译三步
「acode 怎么运行 c 语言」是最常被搜的问题。关键坑是:Alpine 只装 gcc 会报 stdio.h: No such file or directory,因为缺少 musl 的 C 头文件。正确做法:
apk add gcc musl-dev
gcc hello.c -o hello
./hello想一次装齐编译工具链,直接 apk add build-base(包含 gcc、make、musl-dev 等)。下面是一个可运行的 hello.c:
#include <stdio.h>
int main() {
printf("Hello from Acode
");
return 0;
}手机 CPU 编译这种小程序毫无压力;但编译大型项目会明显慢且发热,建议把重编译放到服务器。C++ 同理:apk add g++ 后用 g++ main.cpp -o main 编译,运行方式一样。还有个容易忽略的点:Alpine 的 Node、Python 版本可能比电脑上略旧,遇到语法不兼容时先 node -v 或 python3 --version 确认版本。
一键运行:官方 Runner 插件
Runner 是 Acode 官方组织(Acode-Foundation)维护的开源插件,MIT 协议,源码在 GitHub(acode-runner-plugin)。它给编辑器加一个播放按钮,点击后用内置终端运行当前文件,并自动提示安装缺失的语言包。支持:Python(.py/.pyw)、C(.c)、C++(.cpp/.cxx/.cc/.c++)、Java(.java)、Go(.go)、PHP(.php)、Ruby(.rb)、Rust(.rs)、Lua(.lua/.luau)、Dart(.dart)、Shell(.sh/.bash)。
安装前务必先配置好内置终端,否则播放按钮不出现;配置后如果按钮没显示,重启一次 Acode。安装入口:设置 → 插件 → 搜索 Runner。
其他运行方式:Code Runner、Python 插件、JS 控制台
除了 Runner,还有几个社区方案。Code Runner(acode.coderunner.plugin)可以自定义每种语言的运行命令,适合需要特殊参数的人;它把命令配置存在本地,升级前记得备份。内置 JavaScript 控制台则能直接运行脚本片段看输出,练语法不用建文件。这些方案各有取舍:Runner 最省事,Code Runner 最灵活,JS 控制台最轻。
想看看 Acode 还有哪些值得装的插件?插件扩展页 按语言和用途整理了一份清单。
运行前先把文件路径对齐
终端默认工作目录在 /home,它和 Acode 文件浏览器里的 Public 文件夹指向同一位置(详见 Acode 文件保存在哪)。也就是说:在文件浏览器的 Public 文件夹里新建项目,终端里 cd 后直接就能访问。项目放在手机其他目录时,终端里需要「所有文件访问」权限(Android 10+,Play 版不可用)才能 cd /sdcard/项目名 进入;没有权限就用文件浏览器「添加路径」把目录挂到侧栏,两边配合操作。
终端和编辑器之间还有一条捷径:acode . 把当前终端文件夹在编辑器打开,acode app.js 直接打开某个文件。写完代码回终端运行,运行报错再回编辑器改,全程不用手找路径。
普通用户能做什么,不能做什么
能做到:运行 Node、Python、C/C++、Java、Go、Ruby、Rust、PHP、Lua、Dart、Shell 编写的脚本和小程序;启动本地开发服务器;用 acode . 命令把终端目录直接带到编辑器里打开。
做不到或受限:终端是字符界面,跑不了图形程序;官方终端文档写明,Play 商店版终端的「所有文件访问」权限不可用(仅 Android 10+ 的非 Play 版可用),日常文件访问靠「添加路径」授权;想用完整权限,装 F-Droid 版 或 GitHub Release 版;proot 是用户态虚拟化,性能低于原生 Linux;Alpine 仓库没有的软件装不了;官方没有提供从 C 代码直接打包安卓 App 的一体化流程。长时间编译会发热耗电,属于正常现象。
常见问题速答
- 终端里找不到项目文件?默认在 /home(即 Public 文件夹)。在文件浏览器里把项目目录设为活动工作区,再在终端用
cd进入;或先acode .打开当前目录。 - 命令提示 not found?先
apk update刷新软件源,再apk add对应包。 - Node 报找不到模块?确认已
cd到项目目录,且执行过npm install。 - 运行到一半卡住?按 Ctrl+C 中断;内存不够时先关掉后台应用,再重开终端标签。
- 中文注释乱码?文件编码和终端 locale 的问题,解法见 Acode 文件保存在哪。
一句话总结
acode 如何运行代码,核心就三步:apk add 装运行时,cd 到文件目录,执行对应命令。想要一键体验,再装个 Runner 插件。脚本、学习、小项目,手机完全扛得住;大工程编译请交给服务器。
还没装 Acode?到 下载页 拿官方安装包,装完按这三步把第一个程序跑起来。