FoldRender / 指南 / 在手机上读代码,带真正的语法高亮
FoldRender 指南

在手机上读代码,带真正的语法高亮

源代码渲染(语法高亮加行号)是在干净设备上验证过的四件事之一。本页从头到尾讲操作:把代码库放到手机上、打开一个文件,以及两种搜索方式 —— 有了它们,文件树才变成真能导航的东西,而不只是往下划。

在 Google Play 上获取免费 看看 FoldRender 能做什么

分步操作

  1. 从 Google Play 安装

    FoldRender 在 Play 商店上的名字是 FoldRender: Git Repo Reader,包名 dev.foldrender.app,免费,面向全球发行。照常安装即可 —— 不会弹出要你打开「允许来自此来源的应用」的提示,更新也会自动送达。应用声明了 minSdk 30,所以需要 Android 11 或更新的版本;如果设备低于这个版本,Play 会直接告诉你,而不是让你装上一个跑不起来的版本。

  2. 把代码库放到设备上

    要么克隆,要么指向一个你手上已有的文件夹。克隆:点顶栏里的分支图标,粘贴到 筛选,或输入 owner/repo,点 获取代码;公开仓库可以匿名克隆,不需要账号。用手机上已有的文件夹:点打开文件夹,在 Android 文件夹选择器里授权。授权在重启后依然有效,两种方式打开的文件夹都会成为工作区 —— 区别在于选择器选的文件夹没有 git 功能。

  3. 给第一次列出文件树一点时间

    大仓库(大约 4,600 个文件)第一次列出要很久,只显示一个转圈,没有进度条,也没有文件计数。之后的浏览是按需加载的:每个目录在你展开时才列出它的子项,那一行上有自己的小转圈。

  4. 打开一个源文件

    在文件标签页里,源文件以大写的扩展名作为类型标记。被仓库 .gitignore 匹配的文件默认隐藏 —— 构建产物、node_modules、虚拟环境 —— 真想看锁文件或生成的产物时,用显示被忽略的文件开关把它们显示出来。

  5. 看代码之前先看文件上方那一行

    文件上方是 <Language> · N lines —— 识别出的语言名和行数 —— 如果文件在 32 MB 上限处被截断,后面还会加上 · truncated(中文界面为「<语言> · N 行」和「· 已截断」)。按扩展名能识别大约六十种语言,从 Kotlin、Java、TypeScript、Python、Go、Rust 一直到 Terraform、Protobuf、Nix 和 Zig。高亮是词法层面的,作用于整个文件,行号排在左侧。

  6. 一行超出屏幕时打开换行

    那一行旁边有一个换行开关。关着时,长行横向滚动,行号保持对齐;打开时,长行在阅读栏内折行。合上时一般想要折行;展开时,横向滚动通常更好读。

  7. 在文件内查找

    顶栏里的放大镜会打开查找栏 —— 占位文字是在文档中查找…,有一个 current/total 计数和上下箭头。源代码、日志、纯文本、Markdown、笔记本、CSV 和 JSON/YAML/TOML 都支持。

  8. 在整个工作区里 grep

    左栏的搜索标签页搜索工作区里的每一个文件,而不只是打开的那个。在「在 … 中搜索…」里输入,需要的话打开 .* 按钮,结果会以 path:line 行的形式陆续出现,附带预览;点一条就打开那个文件并跳到那一行。它遵守 .gitignore,跳过二进制文件,跳过大约 1.5 MB 以上的文件,到 500 处匹配就停 —— 这时搜索结果上方会标出「(已截断)」,你就知道该把查询缩小。

  9. 把反复回看的文件留在手边

    快捷标签页收集你打开过的文件。在文件树里长按一个文件可以把它固定为收藏,一个代码库里你真正反复读的那三四个文件就该这样放。

FoldRender 是怎么做的

结构化数据按结构来读

JSON、YAML、TOML 和锁文件以可折叠的树形打开,带 ▸/▾ 展开符,每个节点显示子项数量(数组是 [3],对象是 {5}),有路径导航和一个复制路径按钮 —— 想看原始文本时还有原文开关。Cargo、Poetry、PDM 和 uv 的锁文件按 TOML 解析。

CSV 是一张表,不是一行逗号

CSV 和 TSV 渲染成虚拟化表格,表头行冻结,带行号,按列排序时能识别数字,所以 42 排在 100 前面,而不是后面。

日志按严重级别着色

.log 文件和 logcat 导出会按严重级别着色 —— ERROR、SEVERE、FATAL 和 PANIC 一种颜色,WARN 和 WARNING 一种,DEBUG、TRACE 和 VERBOSE 第三种 —— logcat 写出的单独前缀 E/、W/、D/ 和 V/ 也算在内。

FoldRender 做不到什么?

如实列出的清单 —— 包括已随版本发布但没有验证过的行为 —— 让你在安装前就能判断,这个版本能不能做你要做的那件事。

在 Android 上读仓库还有哪些办法?FoldRender 和它们比怎么样?

大家真正会用的四个应用,以及把它们区分开的那一条:仓库最后在不在手机上,到了手机上有没有东西把它渲染出来。

工具下载价格从哪里获取克隆到设备上渲染 PDF / Jupyter 笔记本 / Markdown编辑器或 shell
FoldRenderUS$0Google Play,全球能 —— HTTPS,公开仓库可匿名能 —— 原生 Compose 渲染器没有,有意为之:它是阅读器,不是 IDE
GitHub MobileUS$0Google Play 和 App Store不能 —— 它读的是托管在 GitHub 上的仓库只有 GitHub 自己渲染的内容,需联网可在 PR 里编辑文件
Termux + gitUS$0F-Droid 或 GitHub能 —— 真正的 git 命令行不能 —— 只有终端文本有,完整的 shell,任何命令行编辑器都能用
MGit 1.7.0 (2023)US$0只在 F-Droid能 —— 克隆、拉取、推送,HTTPS 或 SSH 密钥不能没有 —— 它自己的页面写明不带文本编辑器

价格指的是下载价格。GitHub Mobile 的功能取决于你的 GitHub 套餐;Termux 和 MGit 都是自由软件。MGit 的版本和日期来自它在 F-Droid 上的页面。

FoldRender 的这些数字从哪来?

这里的每个数字都是从正式发布的版本里读出来的,或者来自本页底部列出的一手资料 —— 没有为了好看往上凑整。

常见问题

FoldRender 在 Android 上会给源代码做语法高亮吗?
会 —— 对整个文件做词法高亮,带行号,文件上方那一行显示识别出的语言名和行数,还有一个换行开关。源代码渲染是在干净设备上验证过的四种格式之一。
哪些语言能识别出来?
按扩展名大约六十种,常见的都有 —— Kotlin、Java、Scala、TypeScript、JavaScript、Python、Ruby、Go、Rust、C、C++、C#、Swift、Objective-C、PHP、Lua、R、Julia、Dart、Elixir、Erlang、Haskell、Clojure、shell —— 还有 Terraform、HCL、CMake、Protobuf、GraphQL、Nix 和 Zig 这类基础设施文件。
能搜索所有文件,而不只是打开的那个吗?
能。左栏的「搜索」标签页在整个工作区里 grep,按字面或正则,结果以 path:line 行的形式陆续出现,点一下就跳过去。它遵守 .gitignore,跳过二进制文件。
它是基于 WebView 的查看器吗?
不是。渲染用的是原生 Jetpack Compose。应用里唯一的 WebView 是给 mermaid 和 KaTeX 用的隔离区,禁止网络加载;另外还有同样被限制住的 HTML 文件查看器。
能编辑或运行代码吗?
不能。没有编辑器,没有终端,也不能构建。这是一个阅读工具。
必须克隆仓库吗,还是能读我手上已有的文件夹?
都可以。通过 Android 文件夹选择器授权的文件夹会成为一个持久保存的工作区,文件树、类型标记、搜索和渲染都一样。只是没有 git 功能 —— 那只留给应用自己克隆的仓库。
FoldRender 多少钱?
US$0。在 Google Play 上免费,面向全球发行,版本里没有计费库,没有订阅,也没有付费档。
FoldRender 支持哪些 Android 版本?
Android 11 及以上。应用声明的 minSdk 是 30,也就是 2020 年随 Android 11 发布的 API 级别;编译和目标版本都是 API 36。它在 2025 年发布的 Galaxy Z Fold 7 上开发和测试。
FoldRender 能离线用吗?
能,只要仓库已经在设备上。克隆和拉取需要联网;从克隆下来的仓库或选中的文件夹里阅读、搜索,以及渲染 Markdown、源代码、PDF 和 Jupyter 笔记本都不需要。登录 GitHub 是可选的,只和私有仓库有关。
它和 GitHub Mobile、Termux、MGit 有什么不同?
GitHub Mobile 读的是托管在 GitHub 上的仓库,不会克隆到手机上。Termux 和 MGit 都能克隆,但克隆之后怎么渲染就交给你了 —— Termux 给你一个 shell,MGit 连文本编辑器都没有。FoldRender 通过 HTTPS 克隆,并在内屏上把克隆下来的内容渲染出来。

这些说法去哪里核对?

上面这些数字背后的一手文档,任何一条你都可以自己核对,不必听我们说。

本页最后核对于 2026-08-27。

更多 FoldRender 指南