简介C4Droid手机C编程资源包面向希望在Android设备上随时编写、编译和运行C/C代码的开发者与编程学习者尤其适合缺少PC环境、需要利用碎片时间做原型验证、课程练习或轻量项目尝试的人群。包内共13个文件压缩后约48.91MB以7个APK安装程序为主辅以zip压缩包、头文件、C示例源码以及说明文本和截图可用于搭建手机端编译环境、对照示例理解工程结构。资源中包含C4Droid 4.03汉化完整版及配套终端、键盘、截屏等辅助工具便于在移动端完成代码编辑、控制台调试和运行验证结合默认TCC编译器与GCC插件还能扩展到STL、SDL、Qt等库覆盖图形界面、音视频处理和网络通信等练习场景。已有724人学习适合想低成本体验移动C开发、快速验证代码片段并逐步熟悉移动端工具链的读者参考。1. 手机上的 C 编译器不是玩具c4droid 能干什么、不能干什么地铁上突然想到一段边界判断该怎么写掏出手机就能编出来、跑起来、看到输出——这件事 c4droid 已经能做到。它不是在记事本上套一层代码高亮而是把一套 C/C 编译链路塞进 Android主程序负责编辑和调度GCC 插件负责真正的编译链接产出可执行文件后直接在机器上跑。在「手机编程工具」这个品类里还愿意保留完整编译链路的并不多多数产品要么只做语法检查要么把代码丢到远端服务器。它适合三类人手边没电脑但想把算法思路当场验证的、通勤路上练语法刷题的、拿手机给嵌入式小算法做快速原型的。它不适合大型工程也不适合 UI 复杂的项目屏幕尺寸和输入法会先把耐心磨完。下面按我在手机上拆工程、配参数、踩坑的实际顺序讲。2. 装前先搞懂编译链路主程序、GCC 插件与工作目录很多人第一次装完 c4droid新建文件写了个#include iostream点编译界面安静得像什么都没发生。问题多半不在代码而在组件没对齐。这套工具的编译链路是拆开的编辑器是一个程序编译器是另一个插件图形库又是第三个。任何一环缺失报错信息都不会直白告诉你「你少装了什么」只会甩一句找不到编译器或者找不到头文件。所以动手之前先把三个组件的边界划清楚比盲目试错省时间。2.1 三个组件各管一段装错一个就白忙主程序提供的是编辑器、文件管理、编译任务调度和控制台输出窗口它本身不包含 C 前端。真正干活的是 GCC 插件它带来g前端、libstdc、汇编器和链接器。SDhL 插件是第三个独立包提供 SDL2 的头文件、静态库以及一层衔接 Android 窗口系统的代码。组件负责的部分缺了会怎样主程序编辑器、编译调度、控制台输出没有可用界面GCC 插件C 前端、libstdc、链接器只能编 C或直接提示找不到编译器SDL 插件SDL2 头文件、库、Android 窗口衔接#include SDL2/SDL.h直接报找不到文件选型上有必要说清楚为什么不用在线编译类工具。一是断网就废地铁、电梯、飞机上正是这类工具最该发挥作用的场景二是把代码传到远端再等编译结果来回一趟几十秒验证一个三行的边界判断完全不划算。也不用拿终端模拟器自己搭一套交叉编译环境那套东西配起来要先理解包管理、ABI、sysroot学习成本远超「在手机上跑个循环」这个诉求。c4droid 的价值就在这条链路是闭合的点一下出结果。装的时候顺序上有点讲究先装主程序并至少启动一次让它把工作目录建出来再装 GCC 插件最后装 SDL 插件。有些机型在装完插件后需要把主程序从后台彻底清掉再打开插件才会被识别到——这一步很玄学但确实有效。2.2 权限与工作目录工程别丢在下载目录Android 的存储权限是这套工具最容易翻车的地方。c4droid 需要读写共享存储才能保存源文件和编译产物第一次运行时如果权限弹窗被随手点了拒绝后面新建文件会静默失败或者存到一个你根本找不到的私有目录里。更麻烦的是可执行权限。编译出来的二进制需要放在允许执行的路径上共享存储里某些目录挂载时带了 noexec 标记二进制放进去能编译成功一点运行就报权限拒绝。我一般不去研究具体哪条挂载规则直接用默认工作目录把工程都收在它下面问题就不会出现。路径里带空格和中文也是隐形炸弹。编译命令本质上是把路径拼成一行命令行交给编译器路径里有空格又没被正确转义编译器会把一个路径当成两个参数然后报一个跟真实原因毫无关系的「文件不存在」。工程名、目录名全部用英文加下划线是成本最低的规避方式。位置适合放什么注意应用默认工作目录源文件、头文件、编译产物首选权限和执行标记都由应用自己处理共享存储根目录下自建目录需要导出给别人看的源码、运行结果读写没问题但别指望二进制在这里能跑下载目录临时接收文件路径常带中文和空格别拿它做工程根目录2.3 第一次跑通三行代码验证整条链路装完先别急着写复杂逻辑用最小程序确认「编辑 → 编译 → 运行」三段都通。新建一个hello.cpp内容如下// hello.cpp —— 验证编译链路的最小程序 #include cstdio int main() { printf(c4droid toolchain ok\n); // 只要这行能打印出来链路就是通的 return 0; }保存之后在编译选项里确认标准填的是-stdc17然后点编译。成功的标志不是弹窗提示而是控制台真的输出了c4droid toolchain ok。return 0也别省很多机型上非零返回值会被当成异常退出控制台一闪就没了你还以为程序崩了。链路通了之后立刻验证输入因为交互式程序在手机上比在电脑上更容易出问题// input_check.cpp —— 验证标准输入能不能正常读到数据 #include cstdio int main() { int n 0; printf(n ); if (scanf(%d, n) ! 1) { // scanf 的返回值必须查否则读失败后 n 是脏值 printf(read failed\n); return 1; } printf(n * 2 %d\n, n * 2); return 0; }scanf的返回值是成功匹配的项数这里只有一个%d所以返回 1 才算读到了。不查返回值是新手最常见的翻车点输入框里敲了字母n保持初始值 0程序照样往下跑输出一个看起来「正确」的 0让你误以为逻辑没问题。运行后底部会出现输入框输入数字回车看到n * 2的结果第一段验证才算结束。3. 编译参数怎么设-std、-O2、-lm 与多文件工程参数这一块手机上比电脑上更需要克制。电脑上你可以随手加一堆-Wall -Wextra -Werror -fsanitizeaddress手机上加太多会让编译时间从两秒变成二十秒而屏幕上看不到 IDE 那些波浪线提示警告信息挤在一个小窗口里也读不完。我的原则是标准版本和数学库这两个必须有优化按需开诊断类选项只留一个-Wall。3.1 编译选项逐条拆解c4droid 的编译选项填的是一行字符串多个选项用空格分隔最终会被拼到编译器调用命令里。下面这张表是我手机里常年保留的一组# 填在「编译选项 / Compiler options」里顺序不敏感但 -I 要放在源文件之前才生效 -stdc17 -O2 -Wall -Wextra -I. -lm选项作用什么时候必须加-stdc17指定语言标准用到if constexpr、结构化绑定、std::string_view-O2二级优化做复杂度实验、跑规模稍大的循环-Wall -Wextra打开常用警告建议常开手机上没有其他提示来源-lm链接数学库用到sqrt、pow、sin、log-pthread链接线程库用到std::thread、std::mutex-I.把当前目录加入头文件搜索路径头文件和源文件不在同一层目录-DXXX定义预处理宏同一份代码要区分调试版和正式版-lm是最容易漏的一个。在很多桌面发行版上C 标准库会隐式带上数学库链接不报错交叉编译环境下通常不会sqrt一用就是一条undefined reference to sqrt。这不是代码写错了纯粹是链接参数缺了一项。-I.里的点代表当前工作目录不是源文件所在目录。这两者在 c4droid 里经常不是一回事因为应用的工作目录是固定的你打开的文件可能在某个子目录下。工程里有多层目录时老老实实写-Iinclude这种相对工作目录的路径别指望点号能自动兜底。下面这段代码同时依赖-stdc17和-lm正好可以拿来验证参数有没有生效// algo.cpp —— 需要 -stdc17 与 -lm 才能编过 #include cstdio #include cmath #include string_view int main() { constexpr double k 0.5; // constexpr 在 C11 起可用 std::string_view name algo; // string_view 需要 C17 auto sq [](double x) { return std::sqrt(x); };// sqrt 需要链接 libm printf(%s: %.4f\n, name.data(), sq(k)); return 0; }参数含义逐个对上看k用constexpr是为了让编译器在编译期就把值算出来std::string_view只持有指针和长度不拷贝字符串在小内存环境里比std::string省事std::sqrt的重载解析在 C 里走的是cmath提供的版本最终仍然要-lm才能链接上。3.2 多文件与头文件的相对路径单文件写到几百行之后必然要拆。c4droid 的编译入口默认针对当前打开的源文件多文件工程要么把其他源文件一并交给编译流程要么走 Makefile 工程那条路——具体入口在不同版本里位置不完全一样但思路一致最终要形成一条包含所有.cpp的编译命令。我一般的做法是先拆成「头文件放声明、源文件放实现」的结构本地能跑通再考虑合并。这对以后把代码挪回电脑上继续开发也友好。// util.h —— 只放声明加 include guard避免重复包含 #ifndef UTIL_H #define UTIL_H int clamp_int(int v, int lo, int hi); #endif// util.cpp —— 放实现编译时要和 main.cpp 一起交给编译器 #include util.h int clamp_int(int v, int lo, int hi) { if (v lo) return lo; if (v hi) return hi; return v; }// main.cpp —— 调用方只需要看到声明 #include cstdio #include util.h int main() { printf(%d\n, clamp_int(120, 0, 100)); // 期望输出 100 return 0; }#include util.h用的是双引号编译器会先找源文件所在目录再找-I指定的路径。如果头文件放在include/子目录里就改成#include include/util.h同时确保-I.在选项里。改动之后重新编译链接错误里如果出现undefined reference to clamp_int(int, int, int)说明声明找到了但实现没参与编译——这正是多文件工程里最常见的失败形态问题不在语法在构建配置。如果某个版本确实只支持单文件编译退一步的写法是把实现拆到.cpp里做本地验证最后用#include util.cpp合并成一个翻译单元。这种写法在工程上不推荐会带来重复定义风险但在手机上做算法验证完全够用知道自己在做什么就行。3.3 用 -D 做双端兼容一份代码手机和电脑都能编同一个算法我经常要在手机上写、回电脑上跑性能对比。与其维护两份不如用预处理宏区分。__ANDROID__是交叉编译工具链自动定义的不需要你手动加自己再补一个-DDEBUG之类就能做开关。// compat.cpp —— 同一份代码手机和桌面各自走不同分支 #include cstdio int main() { #ifdef __ANDROID__ setbuf(stdout, nullptr); // 手机终端缓冲更激进先关掉避免输出延迟 printf([android] ); #else printf([desktop] ); #endif #ifdef DEBUG printf(debug build, ); #endif printf(ok\n); return 0; }setbuf(stdout, nullptr)把标准输出改成无缓冲模式每个printf立刻落盘。手机上程序被系统杀掉时不会给你刷新缓冲的机会调试阶段这个设置能省掉很多「明明该有输出却没有」的困惑。发布时把它去掉性能会好一点。-DDEBUG的作用是定义一个名为DEBUG的宏值默认为 1。想在手机上开调试分支就在选项里加-DDEBUG想去掉就删掉代码一行都不用改。反过来用-DNDEBUG关掉assert也是同样的机制。4. 图形与终端SDL2 配置、交互输入与结果落盘纯控制台能覆盖八成需求剩下两成离不开图形和持久化想验证一个坐标变换、想画个棋盘看边界对不对、想把手算结果存成文件回头对。这一章把 SDL2 的最小可用配置、输入输出的细节和文件写入讲清楚都是我在手机上真正跑过的形态。4.1 SDL2 的链接参数与最小窗口SDL 插件装好之后头文件路径由插件提供你只需要在编译选项里补链接参数。常见的一组是-lSDL2 -lm -ldl -llog -landroid其中-ldl是动态加载、-llog是 Android 日志、-landroid提供ANativeActivity相关符号缺一个都可能在某些机型上链接失败。// sdl_min.cpp —— 最小窗口验证图形链路 // 编译选项-stdc17 -O2 -lSDL2 -lm -ldl -llog -landroid #include SDL2/SDL.h #include cstdio int main(int argc, char* argv[]) { if (SDL_Init(SDL_INIT_VIDEO) ! 0) { printf(init failed: %s\n, SDL_GetError()); return 1; } SDL_Window* win SDL_CreateWindow( demo, // 标题 SDL_WINDOWPOS_CENTERED, // x 位置 SDL_WINDOWPOS_CENTERED, // y 位置 640, 480, // 逻辑分辨率不是物理像素 SDL_WINDOW_SHOWN); if (!win) { printf(window failed: %s\n, SDL_GetError()); SDL_Quit(); return 1; } SDL_Delay(1500); // 停留 1.5 秒肉眼确认窗口真的出来了 SDL_DestroyWindow(win); SDL_Quit(); return 0; }main的签名必须带int argc, char* argv[]。SDL2 在部分平台上会把main宏替换成SDL_main签名不对会链接失败报错信息通常是一串看不懂的符号名。640×480 是逻辑尺寸实际渲染时会按屏幕密度缩放别拿它当物理像素去算坐标。先用SDL_Delay代替事件循环是为了把「窗口能不能起来」和「事件处理写没写对」两个问题分开。窗口能显示之后再补SDL_PollEvent循环改一处验证一处比一次性写完再排查省时间。4.2 交互输入scanf 缓冲与 getchar手机上标准输入的表现和桌面有差异最典型的是输出缓冲和行尾处理。桌面终端通常行缓冲换行就刷新手机上的控制台组件行为不一定一致printf之后没有换行符提示语可能一直不显示用户看着空白的输入框不知道该输什么。// input.cpp —— 关缓冲 查返回值两个习惯能挡掉大部分输入问题 #include cstdio int main() { setbuf(stdout, nullptr); // 提示语立刻可见 int n 0; printf(input n: ); if (scanf(%d, n) ! 1) { // 返回 1 才表示成功读到一个整数 printf(bad input\n); return 1; } long long sum 0; for (int i 1; i n; i) sum (long long)i; // 先转 long long 再累加避免溢出 printf(sum %lld\n, sum); return 0; }sum (long long)i这个写法容易被忽略。如果写成sum i虽然sum是long long中间结果的类型提升规则在多数编译器上没问题但一旦换成int sum几万以上就溢出了而手机上跑不出明显症状只会给你一个错得毫无规律的数。混合使用scanf和getchar是另一个高频问题。scanf(%d)会把行尾的换行符留在缓冲区里紧接着的getchar()会立刻读到那个换行符并返回看起来像「输入被吞了」。要么在读完之后手动吃掉一个字符要么干脆全程用fgets读整行再解析后者在手机上更稳。4.3 用文件读写把结果留在手机上控制台输出看完就没了长跑实验的结果需要落盘。手机上最省心的是用绝对路径相对路径依赖当前工作目录而工作目录是什么往往和你以为的不一样。// persist.cpp —— 写文件路径用绝对路径最稳 #include cstdio int main() { const char* path /sdcard/c4droid/out.txt; // 换成你自己确认过可写的位置 FILE* fp fopen(path, w); // w 覆盖写a 追加写 if (!fp) { printf(open failed: %s\n, path); // 目录不存在或没权限都会返回 NULL return 1; } for (int i 0; i 5; i) { fprintf(fp, line %d\n, i); } fclose(fp); // 不 fclose 可能丢最后一段数据 printf(written\n); return 0; }fopen返回NULL时必须立刻停下并打印路径。这条检查我见过太多次被省掉结果程序一路跑到fprintf崩掉报一个和文件权限完全无关的错。fclose同理数据在用户态缓冲区里没刷出去程序被杀就丢了——这不是玄学是缓冲区的正常行为。读回来的写法对称用r模式加fgets逐行读。有个细节fgets会把行尾换行符一起读进来判断内容时要记得把它去掉否则字符串比较永远不相等。5. 常见问题排查五种高频现场的现象、原因与解法下面这五条是我在手机上真正卡过的按遇到频率排序。每一条都按「看到什么 → 为什么 → 怎么改」写照着对号入座比漫无目的地重装快得多。5.1 现象编译按钮点了没反应或提示找不到编译器现象写完代码点编译界面没有任何反馈或者弹出一句找不到编译器 / 找不到g。原因主程序装了但 GCC 插件没装或者装了没被识别。主程序自身只带一个精简的 C 编译器C 前端完全依赖插件。有些机型在插件安装后需要重启应用进程才会重新扫描到。解决先确认插件确实装在同一台设备上然后把主程序从后台清掉重新打开再新建一个只有int main(){return 0;}的文件试编。仍然不行就检查编译选项里有没有残留的非法参数一个拼错的-stdc1z之类会让整个编译命令直接失败表现和「找不到编译器」很像。5.2 现象编译通过链接报 undefined reference现象语法检查全过最后一步链接失败提示undefined reference to sqrt或者某个自定义函数。原因分两类。一类是缺库sqrt、pow需要-lm。另一类是缺实现多文件工程里某个.cpp没参与编译函数只有声明没有定义。解决先看报错的符号名。是标准数学函数就补-lm是自己写的函数就回头检查那个.cpp有没有加入编译、函数签名和声明是否完全一致包括const修饰和参数类型。C 没有参数类型自动放宽int和long在链接器眼里是两个不同的符号。5.3 现象程序中途退出控制台一片空白现象编译成功点了运行控制台什么都没有直接回到编辑器。原因三种可能。数组越界或空指针导致的崩溃输出还在缓冲区里没刷新程序就没了程序进了死循环被系统杀掉。解决先在main开头加setbuf(stdout, nullptr)把缓冲关掉。再在可疑位置插printf打点二分定位到具体行。如果是死循环检查循环变量有没有被修改、浮点比较有没有用。栈上开超大数组也会直接崩几千个元素的int数组就够呛超过一万改用static或者放到堆上。5.4 现象SDL 窗口一闪就回编辑器现象SDL 程序能编译运行时窗口出现不到一秒就消失或者干脆黑屏。原因SDL_Init或SDL_CreateWindow失败但没检查返回值程序继续往下走或者链接参数缺了-llog、-landroid导致某些符号在不该为空的时候为空。解决在每个 SDL 调用后立刻检查返回值和SDL_GetError()把错误信息打印出来。链接参数补齐-lSDL2 -lm -ldl -llog -landroid这一组。另外确认main的签名带上了argc和argv签名不对在部分机型上会静默失败。5.5 现象中文注释变问号字符串输出乱码现象在电脑上写好的源文件拷到手机打开注释里的中文全是问号printf输出的中文字符串是乱码。原因源文件编码和编辑器解析编码不一致。电脑上常见的是 GBK 系编码手机端默认按 UTF-8 解析。另一种情况是源文件确实是 UTF-8但控制台字体不支持部分字形。解决统一存成 UTF-8不带 BOM。手机上新建的文件本来就是 UTF-8问题主要出在电脑传过来的文件转一次编码再传。另外别在标识符里用中文虽然某些编译器允许但换编译器就编不过纯属给自己挖坑。6. 进阶把手机变成随身验证机 —— 模板工程与三条自检真正让手机编程变得可持续的不是某次成功的编译而是一套可以反复复用的起点。我现在的做法是固定一个verify模板一个main.cpp、一段关缓冲的初始化、一个计时用的头部、一个读文件的小工具函数。每次想到新问题就复制一份改名删掉业务代码只留骨架三十秒进入写逻辑的状态不用再重复配参数。// template.cpp —— 随身验证模板的骨架 #include cstdio #include cstdlib #include ctime static void dump(const char* tag, long long v) { printf(%-12s %lld\n, tag, v); // 左对齐输出方便横向对比多组结果 } int main() { setbuf(stdout, nullptr); // 调试期必开 clock_t t0 clock(); // 用 CPU 时钟粗测规模不用高精度计时 long long acc 0; for (int i 0; i 1000000; i) acc i; dump(acc, acc); dump(ms, (long long)((clock() - t0) * 1000 / CLOCKS_PER_SEC)); return 0; }模板里我只留三件事输出立刻可见、有一行耗时、有一个统一的打印函数。前两个是为了排错第三个是为了让输出对齐——手机上屏幕窄printf拼字符串很容易读串行。配好模板之后每次验证一个新想法就固定走三条自检能挡掉绝大多数低级问题。自检项具体动作通过标准编译自检用-Wall -Wextra编一遍逐条读警告没有未使用变量、没有隐式截断运行自检输入最小样例和一组极端值各跑一次最小样例对极端值不崩溢出检查把累加变量和中间结果放大到 64 位再跑结果与手算一致没有翻负极端值这一条最容易被跳过。n 0、n 1、n 负数、n 上限四个输入跑完基本能把边界判断的问题暴露出来。手机输入法敲数字比敲代码慢得多所以我把这几个值直接写进argv或者硬编码成数组循环跑改一行就换一组比每次手动输入快。最后说个血泪经验。有次我在手机上写了个二分查找边界条件改了七八版每次都能编过、都能跑出结果我就以为是对的。回到电脑上用暴力对拍第一组数据就挂了——原因是中间值用了(lo hi) / 2手机上的测试用例规模太小从来没溢出过。从那以后我每次在手机上验证算法都强制用一组接近上限的规模跑一遍不管逻辑看起来多简单。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/30 10:19:22 · 阅读 1.2k c4droid手机C++编译链路配置与排错实战
简介C4Droid手机C编程资源包面向希望在Android设备上随时编写、编译和运行C/C代码的开发者与编程学习者尤其适合缺少PC环境、需要利用碎片时间做原型验证、课程练习或轻量项目尝试的人群。包内共13个文件压缩后约48.91MB以7个APK安装程序为主辅以zip压缩包、头文件、C示例源码以及说明文本和截图可用于搭建手机端编译环境、对照示例理解工程结构。资源中包含C4Droid 4.03汉化完整版及配套终端、键盘、截屏等辅助工具便于在移动端完成代码编辑、控制台调试和运行验证结合默认TCC编译器与GCC插件还能扩展到STL、SDL、Qt等库覆盖图形界面、音视频处理和网络通信等练习场景。已有724人学习适合想低成本体验移动C开发、快速验证代码片段并逐步熟悉移动端工具链的读者参考。1. 手机上的 C 编译器不是玩具c4droid 能干什么、不能干什么地铁上突然想到一段边界判断该怎么写掏出手机就能编出来、跑起来、看到输出——这件事 c4droid 已经能做到。它不是在记事本上套一层代码高亮而是把一套 C/C 编译链路塞进 Android主程序负责编辑和调度GCC 插件负责真正的编译链接产出可执行文件后直接在机器上跑。在「手机编程工具」这个品类里还愿意保留完整编译链路的并不多多数产品要么只做语法检查要么把代码丢到远端服务器。它适合三类人手边没电脑但想把算法思路当场验证的、通勤路上练语法刷题的、拿手机给嵌入式小算法做快速原型的。它不适合大型工程也不适合 UI 复杂的项目屏幕尺寸和输入法会先把耐心磨完。下面按我在手机上拆工程、配参数、踩坑的实际顺序讲。2. 装前先搞懂编译链路主程序、GCC 插件与工作目录很多人第一次装完 c4droid新建文件写了个#include iostream点编译界面安静得像什么都没发生。问题多半不在代码而在组件没对齐。这套工具的编译链路是拆开的编辑器是一个程序编译器是另一个插件图形库又是第三个。任何一环缺失报错信息都不会直白告诉你「你少装了什么」只会甩一句找不到编译器或者找不到头文件。所以动手之前先把三个组件的边界划清楚比盲目试错省时间。2.1 三个组件各管一段装错一个就白忙主程序提供的是编辑器、文件管理、编译任务调度和控制台输出窗口它本身不包含 C 前端。真正干活的是 GCC 插件它带来g前端、libstdc、汇编器和链接器。SDhL 插件是第三个独立包提供 SDL2 的头文件、静态库以及一层衔接 Android 窗口系统的代码。组件负责的部分缺了会怎样主程序编辑器、编译调度、控制台输出没有可用界面GCC 插件C 前端、libstdc、链接器只能编 C或直接提示找不到编译器SDL 插件SDL2 头文件、库、Android 窗口衔接#include SDL2/SDL.h直接报找不到文件选型上有必要说清楚为什么不用在线编译类工具。一是断网就废地铁、电梯、飞机上正是这类工具最该发挥作用的场景二是把代码传到远端再等编译结果来回一趟几十秒验证一个三行的边界判断完全不划算。也不用拿终端模拟器自己搭一套交叉编译环境那套东西配起来要先理解包管理、ABI、sysroot学习成本远超「在手机上跑个循环」这个诉求。c4droid 的价值就在这条链路是闭合的点一下出结果。装的时候顺序上有点讲究先装主程序并至少启动一次让它把工作目录建出来再装 GCC 插件最后装 SDL 插件。有些机型在装完插件后需要把主程序从后台彻底清掉再打开插件才会被识别到——这一步很玄学但确实有效。2.2 权限与工作目录工程别丢在下载目录Android 的存储权限是这套工具最容易翻车的地方。c4droid 需要读写共享存储才能保存源文件和编译产物第一次运行时如果权限弹窗被随手点了拒绝后面新建文件会静默失败或者存到一个你根本找不到的私有目录里。更麻烦的是可执行权限。编译出来的二进制需要放在允许执行的路径上共享存储里某些目录挂载时带了 noexec 标记二进制放进去能编译成功一点运行就报权限拒绝。我一般不去研究具体哪条挂载规则直接用默认工作目录把工程都收在它下面问题就不会出现。路径里带空格和中文也是隐形炸弹。编译命令本质上是把路径拼成一行命令行交给编译器路径里有空格又没被正确转义编译器会把一个路径当成两个参数然后报一个跟真实原因毫无关系的「文件不存在」。工程名、目录名全部用英文加下划线是成本最低的规避方式。位置适合放什么注意应用默认工作目录源文件、头文件、编译产物首选权限和执行标记都由应用自己处理共享存储根目录下自建目录需要导出给别人看的源码、运行结果读写没问题但别指望二进制在这里能跑下载目录临时接收文件路径常带中文和空格别拿它做工程根目录2.3 第一次跑通三行代码验证整条链路装完先别急着写复杂逻辑用最小程序确认「编辑 → 编译 → 运行」三段都通。新建一个hello.cpp内容如下// hello.cpp —— 验证编译链路的最小程序 #include cstdio int main() { printf(c4droid toolchain ok\n); // 只要这行能打印出来链路就是通的 return 0; }保存之后在编译选项里确认标准填的是-stdc17然后点编译。成功的标志不是弹窗提示而是控制台真的输出了c4droid toolchain ok。return 0也别省很多机型上非零返回值会被当成异常退出控制台一闪就没了你还以为程序崩了。链路通了之后立刻验证输入因为交互式程序在手机上比在电脑上更容易出问题// input_check.cpp —— 验证标准输入能不能正常读到数据 #include cstdio int main() { int n 0; printf(n ); if (scanf(%d, n) ! 1) { // scanf 的返回值必须查否则读失败后 n 是脏值 printf(read failed\n); return 1; } printf(n * 2 %d\n, n * 2); return 0; }scanf的返回值是成功匹配的项数这里只有一个%d所以返回 1 才算读到了。不查返回值是新手最常见的翻车点输入框里敲了字母n保持初始值 0程序照样往下跑输出一个看起来「正确」的 0让你误以为逻辑没问题。运行后底部会出现输入框输入数字回车看到n * 2的结果第一段验证才算结束。3. 编译参数怎么设-std、-O2、-lm 与多文件工程参数这一块手机上比电脑上更需要克制。电脑上你可以随手加一堆-Wall -Wextra -Werror -fsanitizeaddress手机上加太多会让编译时间从两秒变成二十秒而屏幕上看不到 IDE 那些波浪线提示警告信息挤在一个小窗口里也读不完。我的原则是标准版本和数学库这两个必须有优化按需开诊断类选项只留一个-Wall。3.1 编译选项逐条拆解c4droid 的编译选项填的是一行字符串多个选项用空格分隔最终会被拼到编译器调用命令里。下面这张表是我手机里常年保留的一组# 填在「编译选项 / Compiler options」里顺序不敏感但 -I 要放在源文件之前才生效 -stdc17 -O2 -Wall -Wextra -I. -lm选项作用什么时候必须加-stdc17指定语言标准用到if constexpr、结构化绑定、std::string_view-O2二级优化做复杂度实验、跑规模稍大的循环-Wall -Wextra打开常用警告建议常开手机上没有其他提示来源-lm链接数学库用到sqrt、pow、sin、log-pthread链接线程库用到std::thread、std::mutex-I.把当前目录加入头文件搜索路径头文件和源文件不在同一层目录-DXXX定义预处理宏同一份代码要区分调试版和正式版-lm是最容易漏的一个。在很多桌面发行版上C 标准库会隐式带上数学库链接不报错交叉编译环境下通常不会sqrt一用就是一条undefined reference to sqrt。这不是代码写错了纯粹是链接参数缺了一项。-I.里的点代表当前工作目录不是源文件所在目录。这两者在 c4droid 里经常不是一回事因为应用的工作目录是固定的你打开的文件可能在某个子目录下。工程里有多层目录时老老实实写-Iinclude这种相对工作目录的路径别指望点号能自动兜底。下面这段代码同时依赖-stdc17和-lm正好可以拿来验证参数有没有生效// algo.cpp —— 需要 -stdc17 与 -lm 才能编过 #include cstdio #include cmath #include string_view int main() { constexpr double k 0.5; // constexpr 在 C11 起可用 std::string_view name algo; // string_view 需要 C17 auto sq [](double x) { return std::sqrt(x); };// sqrt 需要链接 libm printf(%s: %.4f\n, name.data(), sq(k)); return 0; }参数含义逐个对上看k用constexpr是为了让编译器在编译期就把值算出来std::string_view只持有指针和长度不拷贝字符串在小内存环境里比std::string省事std::sqrt的重载解析在 C 里走的是cmath提供的版本最终仍然要-lm才能链接上。3.2 多文件与头文件的相对路径单文件写到几百行之后必然要拆。c4droid 的编译入口默认针对当前打开的源文件多文件工程要么把其他源文件一并交给编译流程要么走 Makefile 工程那条路——具体入口在不同版本里位置不完全一样但思路一致最终要形成一条包含所有.cpp的编译命令。我一般的做法是先拆成「头文件放声明、源文件放实现」的结构本地能跑通再考虑合并。这对以后把代码挪回电脑上继续开发也友好。// util.h —— 只放声明加 include guard避免重复包含 #ifndef UTIL_H #define UTIL_H int clamp_int(int v, int lo, int hi); #endif// util.cpp —— 放实现编译时要和 main.cpp 一起交给编译器 #include util.h int clamp_int(int v, int lo, int hi) { if (v lo) return lo; if (v hi) return hi; return v; }// main.cpp —— 调用方只需要看到声明 #include cstdio #include util.h int main() { printf(%d\n, clamp_int(120, 0, 100)); // 期望输出 100 return 0; }#include util.h用的是双引号编译器会先找源文件所在目录再找-I指定的路径。如果头文件放在include/子目录里就改成#include include/util.h同时确保-I.在选项里。改动之后重新编译链接错误里如果出现undefined reference to clamp_int(int, int, int)说明声明找到了但实现没参与编译——这正是多文件工程里最常见的失败形态问题不在语法在构建配置。如果某个版本确实只支持单文件编译退一步的写法是把实现拆到.cpp里做本地验证最后用#include util.cpp合并成一个翻译单元。这种写法在工程上不推荐会带来重复定义风险但在手机上做算法验证完全够用知道自己在做什么就行。3.3 用 -D 做双端兼容一份代码手机和电脑都能编同一个算法我经常要在手机上写、回电脑上跑性能对比。与其维护两份不如用预处理宏区分。__ANDROID__是交叉编译工具链自动定义的不需要你手动加自己再补一个-DDEBUG之类就能做开关。// compat.cpp —— 同一份代码手机和桌面各自走不同分支 #include cstdio int main() { #ifdef __ANDROID__ setbuf(stdout, nullptr); // 手机终端缓冲更激进先关掉避免输出延迟 printf([android] ); #else printf([desktop] ); #endif #ifdef DEBUG printf(debug build, ); #endif printf(ok\n); return 0; }setbuf(stdout, nullptr)把标准输出改成无缓冲模式每个printf立刻落盘。手机上程序被系统杀掉时不会给你刷新缓冲的机会调试阶段这个设置能省掉很多「明明该有输出却没有」的困惑。发布时把它去掉性能会好一点。-DDEBUG的作用是定义一个名为DEBUG的宏值默认为 1。想在手机上开调试分支就在选项里加-DDEBUG想去掉就删掉代码一行都不用改。反过来用-DNDEBUG关掉assert也是同样的机制。4. 图形与终端SDL2 配置、交互输入与结果落盘纯控制台能覆盖八成需求剩下两成离不开图形和持久化想验证一个坐标变换、想画个棋盘看边界对不对、想把手算结果存成文件回头对。这一章把 SDL2 的最小可用配置、输入输出的细节和文件写入讲清楚都是我在手机上真正跑过的形态。4.1 SDL2 的链接参数与最小窗口SDL 插件装好之后头文件路径由插件提供你只需要在编译选项里补链接参数。常见的一组是-lSDL2 -lm -ldl -llog -landroid其中-ldl是动态加载、-llog是 Android 日志、-landroid提供ANativeActivity相关符号缺一个都可能在某些机型上链接失败。// sdl_min.cpp —— 最小窗口验证图形链路 // 编译选项-stdc17 -O2 -lSDL2 -lm -ldl -llog -landroid #include SDL2/SDL.h #include cstdio int main(int argc, char* argv[]) { if (SDL_Init(SDL_INIT_VIDEO) ! 0) { printf(init failed: %s\n, SDL_GetError()); return 1; } SDL_Window* win SDL_CreateWindow( demo, // 标题 SDL_WINDOWPOS_CENTERED, // x 位置 SDL_WINDOWPOS_CENTERED, // y 位置 640, 480, // 逻辑分辨率不是物理像素 SDL_WINDOW_SHOWN); if (!win) { printf(window failed: %s\n, SDL_GetError()); SDL_Quit(); return 1; } SDL_Delay(1500); // 停留 1.5 秒肉眼确认窗口真的出来了 SDL_DestroyWindow(win); SDL_Quit(); return 0; }main的签名必须带int argc, char* argv[]。SDL2 在部分平台上会把main宏替换成SDL_main签名不对会链接失败报错信息通常是一串看不懂的符号名。640×480 是逻辑尺寸实际渲染时会按屏幕密度缩放别拿它当物理像素去算坐标。先用SDL_Delay代替事件循环是为了把「窗口能不能起来」和「事件处理写没写对」两个问题分开。窗口能显示之后再补SDL_PollEvent循环改一处验证一处比一次性写完再排查省时间。4.2 交互输入scanf 缓冲与 getchar手机上标准输入的表现和桌面有差异最典型的是输出缓冲和行尾处理。桌面终端通常行缓冲换行就刷新手机上的控制台组件行为不一定一致printf之后没有换行符提示语可能一直不显示用户看着空白的输入框不知道该输什么。// input.cpp —— 关缓冲 查返回值两个习惯能挡掉大部分输入问题 #include cstdio int main() { setbuf(stdout, nullptr); // 提示语立刻可见 int n 0; printf(input n: ); if (scanf(%d, n) ! 1) { // 返回 1 才表示成功读到一个整数 printf(bad input\n); return 1; } long long sum 0; for (int i 1; i n; i) sum (long long)i; // 先转 long long 再累加避免溢出 printf(sum %lld\n, sum); return 0; }sum (long long)i这个写法容易被忽略。如果写成sum i虽然sum是long long中间结果的类型提升规则在多数编译器上没问题但一旦换成int sum几万以上就溢出了而手机上跑不出明显症状只会给你一个错得毫无规律的数。混合使用scanf和getchar是另一个高频问题。scanf(%d)会把行尾的换行符留在缓冲区里紧接着的getchar()会立刻读到那个换行符并返回看起来像「输入被吞了」。要么在读完之后手动吃掉一个字符要么干脆全程用fgets读整行再解析后者在手机上更稳。4.3 用文件读写把结果留在手机上控制台输出看完就没了长跑实验的结果需要落盘。手机上最省心的是用绝对路径相对路径依赖当前工作目录而工作目录是什么往往和你以为的不一样。// persist.cpp —— 写文件路径用绝对路径最稳 #include cstdio int main() { const char* path /sdcard/c4droid/out.txt; // 换成你自己确认过可写的位置 FILE* fp fopen(path, w); // w 覆盖写a 追加写 if (!fp) { printf(open failed: %s\n, path); // 目录不存在或没权限都会返回 NULL return 1; } for (int i 0; i 5; i) { fprintf(fp, line %d\n, i); } fclose(fp); // 不 fclose 可能丢最后一段数据 printf(written\n); return 0; }fopen返回NULL时必须立刻停下并打印路径。这条检查我见过太多次被省掉结果程序一路跑到fprintf崩掉报一个和文件权限完全无关的错。fclose同理数据在用户态缓冲区里没刷出去程序被杀就丢了——这不是玄学是缓冲区的正常行为。读回来的写法对称用r模式加fgets逐行读。有个细节fgets会把行尾换行符一起读进来判断内容时要记得把它去掉否则字符串比较永远不相等。5. 常见问题排查五种高频现场的现象、原因与解法下面这五条是我在手机上真正卡过的按遇到频率排序。每一条都按「看到什么 → 为什么 → 怎么改」写照着对号入座比漫无目的地重装快得多。5.1 现象编译按钮点了没反应或提示找不到编译器现象写完代码点编译界面没有任何反馈或者弹出一句找不到编译器 / 找不到g。原因主程序装了但 GCC 插件没装或者装了没被识别。主程序自身只带一个精简的 C 编译器C 前端完全依赖插件。有些机型在插件安装后需要重启应用进程才会重新扫描到。解决先确认插件确实装在同一台设备上然后把主程序从后台清掉重新打开再新建一个只有int main(){return 0;}的文件试编。仍然不行就检查编译选项里有没有残留的非法参数一个拼错的-stdc1z之类会让整个编译命令直接失败表现和「找不到编译器」很像。5.2 现象编译通过链接报 undefined reference现象语法检查全过最后一步链接失败提示undefined reference to sqrt或者某个自定义函数。原因分两类。一类是缺库sqrt、pow需要-lm。另一类是缺实现多文件工程里某个.cpp没参与编译函数只有声明没有定义。解决先看报错的符号名。是标准数学函数就补-lm是自己写的函数就回头检查那个.cpp有没有加入编译、函数签名和声明是否完全一致包括const修饰和参数类型。C 没有参数类型自动放宽int和long在链接器眼里是两个不同的符号。5.3 现象程序中途退出控制台一片空白现象编译成功点了运行控制台什么都没有直接回到编辑器。原因三种可能。数组越界或空指针导致的崩溃输出还在缓冲区里没刷新程序就没了程序进了死循环被系统杀掉。解决先在main开头加setbuf(stdout, nullptr)把缓冲关掉。再在可疑位置插printf打点二分定位到具体行。如果是死循环检查循环变量有没有被修改、浮点比较有没有用。栈上开超大数组也会直接崩几千个元素的int数组就够呛超过一万改用static或者放到堆上。5.4 现象SDL 窗口一闪就回编辑器现象SDL 程序能编译运行时窗口出现不到一秒就消失或者干脆黑屏。原因SDL_Init或SDL_CreateWindow失败但没检查返回值程序继续往下走或者链接参数缺了-llog、-landroid导致某些符号在不该为空的时候为空。解决在每个 SDL 调用后立刻检查返回值和SDL_GetError()把错误信息打印出来。链接参数补齐-lSDL2 -lm -ldl -llog -landroid这一组。另外确认main的签名带上了argc和argv签名不对在部分机型上会静默失败。5.5 现象中文注释变问号字符串输出乱码现象在电脑上写好的源文件拷到手机打开注释里的中文全是问号printf输出的中文字符串是乱码。原因源文件编码和编辑器解析编码不一致。电脑上常见的是 GBK 系编码手机端默认按 UTF-8 解析。另一种情况是源文件确实是 UTF-8但控制台字体不支持部分字形。解决统一存成 UTF-8不带 BOM。手机上新建的文件本来就是 UTF-8问题主要出在电脑传过来的文件转一次编码再传。另外别在标识符里用中文虽然某些编译器允许但换编译器就编不过纯属给自己挖坑。6. 进阶把手机变成随身验证机 —— 模板工程与三条自检真正让手机编程变得可持续的不是某次成功的编译而是一套可以反复复用的起点。我现在的做法是固定一个verify模板一个main.cpp、一段关缓冲的初始化、一个计时用的头部、一个读文件的小工具函数。每次想到新问题就复制一份改名删掉业务代码只留骨架三十秒进入写逻辑的状态不用再重复配参数。// template.cpp —— 随身验证模板的骨架 #include cstdio #include cstdlib #include ctime static void dump(const char* tag, long long v) { printf(%-12s %lld\n, tag, v); // 左对齐输出方便横向对比多组结果 } int main() { setbuf(stdout, nullptr); // 调试期必开 clock_t t0 clock(); // 用 CPU 时钟粗测规模不用高精度计时 long long acc 0; for (int i 0; i 1000000; i) acc i; dump(acc, acc); dump(ms, (long long)((clock() - t0) * 1000 / CLOCKS_PER_SEC)); return 0; }模板里我只留三件事输出立刻可见、有一行耗时、有一个统一的打印函数。前两个是为了排错第三个是为了让输出对齐——手机上屏幕窄printf拼字符串很容易读串行。配好模板之后每次验证一个新想法就固定走三条自检能挡掉绝大多数低级问题。自检项具体动作通过标准编译自检用-Wall -Wextra编一遍逐条读警告没有未使用变量、没有隐式截断运行自检输入最小样例和一组极端值各跑一次最小样例对极端值不崩溢出检查把累加变量和中间结果放大到 64 位再跑结果与手算一致没有翻负极端值这一条最容易被跳过。n 0、n 1、n 负数、n 上限四个输入跑完基本能把边界判断的问题暴露出来。手机输入法敲数字比敲代码慢得多所以我把这几个值直接写进argv或者硬编码成数组循环跑改一行就换一组比每次手动输入快。最后说个血泪经验。有次我在手机上写了个二分查找边界条件改了七八版每次都能编过、都能跑出结果我就以为是对的。回到电脑上用暴力对拍第一组数据就挂了——原因是中间值用了(lo hi) / 2手机上的测试用例规模太小从来没溢出过。从那以后我每次在手机上验证算法都强制用一组接近上限的规模跑一遍不管逻辑看起来多简单。希望帮到你。本文还有配套的精品资源点击获取