简介：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 窗口系统的代码。

选型上有必要说清楚为什么不用在线编译类工具。一是断网就废，地铁、电梯、飞机上正是这类工具最该发挥作用的场景；二是把代码传到远端再等编译结果，来回一趟几十秒，验证一个三行的边界判断完全不划算。也不用拿终端模拟器自己搭一套交叉编译环境，那套东西配起来要先理解包管理、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; }

保存之后在编译选项里确认标准填的是-std=c++17，然后点编译。成功的标志不是弹窗提示，而是控制台真的输出了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 -fsanitize=address，手机上加太多会让编译时间从两秒变成二十秒，而屏幕上看不到 IDE 那些波浪线提示，警告信息挤在一个小窗口里也读不完。我的原则是：标准版本和数学库这两个必须有，优化按需开，诊断类选项只留一个-Wall。

3.1 编译选项逐条拆解

c4droid 的编译选项填的是一行字符串，多个选项用空格分隔，最终会被拼到编译器调用命令里。下面这张表是我手机里常年保留的一组：

# 填在「编译选项 / Compiler options」里，顺序不敏感，但 -I 要放在源文件之前才生效 -std=c++17 -O2 -Wall -Wextra -I. -lm

-lm是最容易漏的一个。在很多桌面发行版上，C++ 标准库会隐式带上数学库，链接不报错；交叉编译环境下通常不会，sqrt一用就是一条undefined reference to 'sqrt'。这不是代码写错了，纯粹是链接参数缺了一项。

-I.里的点代表当前工作目录，不是源文件所在目录。这两者在 c4droid 里经常不是一回事，因为应用的工作目录是固定的，你打开的文件可能在某个子目录下。工程里有多层目录时，老老实实写-Iinclude这种相对工作目录的路径，别指望点号能自动兜底。

下面这段代码同时依赖-std=c++17和-lm，正好可以拿来验证参数有没有生效：

// algo.cpp —— 需要 -std=c++17 与 -lm 才能编过 #include <cstdio> #include <cmath> #include <string_view> int main() { constexpr double k = 0.5; // constexpr 在 C++11 起可用 std::string_view name = "algo"; // string_view 需要 C++17 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 —— 最小窗口，验证图形链路 // 编译选项：-std=c++17 -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;}的文件试编。仍然不行就检查编译选项里有没有残留的非法参数，一个拼错的-std=c++1z之类会让整个编译命令直接失败，表现和「找不到编译器」很像。

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拼字符串很容易读串行。

配好模板之后，每次验证一个新想法就固定走三条自检，能挡掉绝大多数低级问题。

极端值这一条最容易被跳过。n = 0、n = 1、n = 负数、n = 上限，四个输入跑完，基本能把边界判断的问题暴露出来。手机输入法敲数字比敲代码慢得多，所以我把这几个值直接写进argv或者硬编码成数组循环跑，改一行就换一组，比每次手动输入快。

最后说个血泪经验。有次我在手机上写了个二分查找，边界条件改了七八版，每次都能编过、都能跑出结果，我就以为是对的。回到电脑上用暴力对拍，第一组数据就挂了——原因是中间值用了(lo + hi) / 2，手机上的测试用例规模太小，从来没溢出过。从那以后我每次在手机上验证算法，都强制用一组接近上限的规模跑一遍，不管逻辑看起来多简单。希望帮到你。

本文还有配套的精品资源，点击获取