Termux 无法直接运行 Java GUI 程序，因其纯终端环境缺失 X Server 和 DISPLAY 变量，Java 默认启用 headless 模式且 openjdk-17 不含 AWT 原生库；可行方案是通过 proot-distro 部署 Ubuntu，安装 XFCE 与 TightVNC，配置 xstartup 并启动 vncserver，再在 VNC 桌面中安装 OpenJDK 并设置 DISPLAY=:1 运行 Java 程序。
Termux 本身不支持 Java 图形化程序（AWT/Swing），直接运行会报 No X11 DISPLAY variable was set 或 HeadlessException —— 不是配置没对，而是根本缺图形后端。
为什么 Termux 无法直接运行 Java GUI 程序
Termux 是纯终端环境，没有 X Server，也不提供 DISPLAY。Java 的 java.awt.GraphicsEnvironment 检测到 headless 模式（默认开启）后，会拒绝初始化 GUI 组件。即使你装了 openjdk-17，SwingUtilities.invokeLater 也会静默失败或抛 HeadlessException。
- Termux 的
pkg install openjdk-17不含 AWT 原生库（libawt_x11.so等），只提供 headless 实现 - Android 系统层禁用了大部分 X11 相关系统调用，
startx或Xwayland无法原生启动 - 所谓“X11 转发”在 Termux 中不成立：它不是 SSH 客户端，没有
ssh -X那套机制
可行路径：用 VNC + 桌面环境模拟 X11
绕过 Termux 的限制，得靠外部图形栈。最稳定的方式是起一个轻量级 Linux 桌面（如 XFCE），再通过 VNC 暴露给手机查看 —— 这本质是“在 Android 上跑一个微型 Linux 虚拟桌面”，Termux 只负责启动和转发。
- 必须先安装
proot-distro（不是termux-distro）并部署 Debian/Ubuntu：proot-distro install ubuntu-22.04 - 进入 distro 后，装 XFCE 和 TightVNC：
apt install xfce4 tigervnc-standalone-server - 配置
~/.vnc/xstartup，确保以startxfce4启动（不是twm或空文件） - 在 Termux 中用
vncserver :1 -localhost no -geometry 1024x768启动，再用手机 VNC 客户端连127.0.0.1:5901 - 进桌面后，再装 OpenJDK（
apt install openjdk-17-jdk），此时DISPLAY=:1才真正有效
Java 程序启动时的关键环境变量
即使有了 VNC 桌面，Java 进程仍需明确告知图形后端位置。不能依赖系统自动推断。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 必须显式设置
DISPLAY=:1（注意冒号前无空格，且与vncserver的 display 号一致） - 避免加
-Djava.awt.headless=true—— 这是默认值，加了就彻底锁死 GUI - 若用
javac编译后再java运行，确保两者都在同一环境里执行：DISPLAY=:1 java MyGuiApp - 某些 JDK 版本（如 Temurin）在 ARM64 Android 上对 X11 字体路径敏感，可临时加
-Dawt.useSystemAAFontSettings=on
常见失败现象与对应检查点
看到黑屏、闪退、或控制台输出却无窗口？大概率卡在这几个地方：
- VNC 客户端连上了但桌面空白 → 检查
~/.vnc/xstartup权限是否为chmod +x，内容是否以#!/bin/sh开头并包含exec startxfce4 - Java 报
Can't connect to X11 window server→echo $DISPLAY是否输出:1；确认vncserver进程仍在运行（ps aux | grep vnc） - 窗口弹出但按钮/文字不渲染 → 是字体或 GTK 主题缺失，进桌面后运行
sudo apt install fonts-dejavu-gtk2，或改用java -Dswing.aatext=true - Termux 崩溃或 ANR → 别在 Termux 主界面直接跑
vncserver，务必用proot-distro login ubuntu-22.04进入子环境再操作
真正麻烦的不是命令怎么敲，而是每层环境（Termux → proot → distro → VNC → Java）的 DISPLAY、权限、路径都得对齐。漏一个，GUI 就停在黑屏那帧。
