单文件Java程序实现《孙子兵法·始计篇》中英对照阅读器，支持翻页、快捷键与离屏导出

近日，一名开发者公开了一款极简但功能完整的古典文献阅读工具：仅用一个 Java 源文件（SunziReaderGui.java），实现了《孙子兵法·始计篇》的中英对照交互式阅读界面。该程序以图形用户界面（GUI）呈现内容，左侧为七段式段落导航，中间为繁体中文原文，右侧为 Lionel Giles 于1910年出版的经典英译本，支持鼠标点击跳转、键盘快捷操作，并可在无图形界面环境下生成 PNG 预览图。

该项目灵感源于此前同类实践——即用单个 Java 文件实现《论语·学而》的中英对照阅读器。开发者注意到 ctext.org 提供的《孙子兵法·始计篇》恰好按七个小节组织，并附有 Giles 译文，结构清晰、适配性强，遂复用相同技术框架进行迁移开发。整个实现未引入任何第三方库，完全依赖 JDK 自带的 AWT/Swing 组件，编译运行仅需标准 JDK 15 或更高版本（因使用了文本块与 switch 表达式等现代语法特性），作者已在 JDK 21 环境下完成验证。

界面布局采用 BorderLayout 三栏结构：左栏固定宽度 212 像素用于段落编号按钮；右栏 430 像素承载英文翻译；中间区域自适应填充剩余空间，显示繁体中文原文。所有文字均自动换行，切换段落时两侧滚动位置同步归零，避免错位。段落按钮在当前选中状态下以朱砂红底高亮显示，同时禁用“上一段”或“下一段”按钮（首段禁用前者，末段禁用后者），逻辑通过 showSection() 方法集中管理状态更新，确保界面切换无中间态闪烁。

交互设计兼顾效率与易用性。除鼠标点击外，支持方向键 ← / → 切换前后段落，Home / End 键快速跳转至首尾段；页脚实时显示“第 n 段 / 共 7 段”，并提示快捷键组合。右下角设“資料來源 · ctext.org ↗”超链接，悬停时变色为朱红色，点击后调用系统默认浏览器打开对应网页；若运行环境为 headless 模式（如服务器端无 GUI），则弹出 JOptionPane 对话框展示 URL，避免静默失败。值得一提的是，该链接在 --preview 模式下不触发弹窗，而是直接渲染为图像输出，本文配图即由此生成。

视觉风格统一采用繁体中文文案，字体回退策略为 Kaiti SC → Noto Serif CJK TC → Songti SC，确保跨平台一致性；所有 UI 元素（包括段号按钮、翻页胶囊、印章图标等）均由 paintComponent 自定义绘制，外观独立于系统主题，增强可预测性与美观度。当前段高亮样式通过“选中态优先于禁用态”的逻辑实现，使按钮在被禁用时仍能保留视觉反馈。

程序支持多种运行模式：

默认启动：java -cp /tmp/sunzi-build SunziReaderGui
指定段落启动：java -cp /tmp/sunzi-build SunziReaderGui --section 6
离屏导出 PNG：java -Djava.awt.headless=true -cp /tmp/sunzi-build SunziReaderGui --preview out.png

其中 --preview 模式是关键创新点之一。它绕过真实窗口创建流程，先调用 buildPanel() 构建组件树，再手动触发 doLayout() 完整布局，最后通过 printAll() 将内容绘制到 BufferedImage 中保存为图片。这一机制使得该工具可在 CI/CD 流水线、文档自动化生成等无头环境中稳定工作，极大拓展了其应用场景。

从技术角度看，该项目体现了 Java 桌面开发在轻量级工具构建中的独特优势：无需 Maven/Gradle 依赖管理，单文件即可部署；AWT/Swing 虽非主流前端方案，但在确定性渲染、低资源占用与跨平台兼容性方面仍有不可替代的价值。尤其在教育、古籍数字化、开发者教学演示等领域，此类“最小可行 GUI”项目具有示范意义。

值得注意的是，该工具的数据部分——即七段原文与对应英译——以硬编码字符串数组形式嵌入源码，未采用外部配置或网络请求。这种设计牺牲了一定灵活性，却换来极致的可移植性与离线可用性。对于《孙子兵法》这类篇幅有限、结构稳定的经典文本，该权衡是合理且高效的。

近年来，随着大模型与 RAG（检索增强生成）技术普及，古籍数字化更多聚焦于向量化存储与语义检索。例如，LangChain 生态中常用 Document 对象封装文本内容，结合 Embeddings 与 Vector Stores 实现“按意查文”。然而，这类方案通常需要完整服务栈支撑，对终端用户而言门槛较高。相比之下，本项目回归“单机本地应用”本质，以最朴素的方式解决核心需求：清晰、稳定、即时地呈现文本内容。它不追求智能问答或上下文推理，而是专注做好“阅读”这件事本身。

这种极简主义开发思路，在当下技术堆叠盛行的环境中反而显得珍贵。它提醒我们：并非所有问题都需要复杂架构来解答；有时，一行精心编排的 Swing 代码，比一套微服务更能直击用户痛点。尤其对中文古籍爱好者、语言学习者或教育工作者而言，一个无需安装、双击即用、界面整洁的本地阅读器，其实际价值可能远超某些云端 AI 助手。

目前，完整源码已公开于社区（链接见原始素材），开发者明确说明代码由 trae 辅助生成，并经本人在 JDK 21 下逐行核验。该项目虽小，却完整覆盖了 GUI 开发中的典型挑战：布局管理、状态同步、字体适配、事件处理、离屏渲染与异常兜底，堪称一份高质量的 Java Swing 实战范例。

在开源文化持续演进的今天，这类“一人一文件”的微型项目正成为技术传承的新载体。它们未必改变行业格局，却为后来者提供了可触摸、可运行、可修改的学习样本——正如两千年前孙武写下“兵者，诡道也”，今日开发者亦以代码为笔，续写技术之道的务实与精巧。