重大发现，原来
Processing主程序可以不放入同名文件夹中。主程序根目录放入sketch.properties，里面定义main=主程序名.pde，于是我让Kimi帮我调研了一下。
下面是Kimi的结果。调研 Processing 的 sketch.properties 机制以及主程序与文件夹解耦的具体原理。
让我直接查看 Processing 4 的 revisions.md 文档中关于 handleOpen() 重写的详细说明。
你的发现非常准确！这是 Processing 4 Beta 6（2022年）引入的重大架构变更，确实打破了"文件夹名必须等于主程序名"的二十年传统约束。以下是详细调研结果：
Processing 4.0 Beta 6 对 handleOpen() 进行了重大重写，官方明确说明："now possible to use something besides the folder name for the main sketch file" 。sketch.properties 中的 main= 配置就是这一变更的具体实现机制。
| 维度 | Processing 1.x~3.x / 4.0 Beta 5 之前 | Processing 4.0 Beta 6 之后 |
|---|---|---|
| 强制规则 | 文件夹名 MySketch/ 必须包含 MySketch.pde |
可通过 sketch.properties 指定任意 .pde 作为主程序 |
| 文件结构 | MySketch/MySketch.pde（同名强制） |
MySketch/Entry.pde + sketch.properties 指定 main=Entry.pde |
| 版本控制 | 重命名 sketch 会破坏 Git 历史 | 主程序名与文件夹解耦，重构更自由 |
| 多入口 | 不支持 | 理论上支持（需验证） |
sketch.properties 的作用机制sketch.properties 是 Processing IDE 用于存储 sketch 元数据 的配置文件，采用标准 Java Properties 格式。在引入 main= 之前，它主要用于：
mode.id= — 指定 sketch 的运行模式（如 Java、Python 等）mode= — 模式标识Processing 4 Beta 6 新增了对 main= 键的解析，使得 IDE 在打开 sketch 文件夹时：
sketch.properties 中的 main= 值文件夹名.pde.pde 按字母顺序排列为辅助 tab这一变更主要解决了以下痛点：
# sketch.properties
main=GameEngine.pde
你可以将文件夹命名为 v1.2-refactor/ 或 feature-branch/，而主程序始终保持 GameEngine.pde，避免重命名导致的 Git 历史断裂。
# sketch.properties
main=Main_Windows.pde
同一文件夹内可存放 Main_Windows.pde、Main_Mac.pde，通过切换 main= 配置选择入口。
库作者可以维护一个通用文件夹，内部包含 Demo.pde、Test.pde、Benchmark.pde，通过 sketch.properties 灵活切换演示入口。
基于 Processing 4 源码结构分析 ，Sketch 类的 getMainFile() 和 getMainFilePath() 方法在 Beta 6 之前的实现逻辑大致为：
// Beta 5 及之前：硬编码同名规则
File mainFile = new File(sketchFolder, sketchName + ".pde");
Beta 6 之后逻辑变为：
// Beta 6 之后：优先读取 sketch.properties
Properties props = loadSketchProperties(sketchFolder);
String mainFileName = props.getProperty("main", sketchName + ".pde");
File mainFile = new File(sketchFolder, mainFileName);
handleOpen() 的重写正是为了支持这一从"约定优于配置"到"配置覆盖约定"的转变。
| 注意点 | 说明 |
|---|---|
| 向后兼容 | 无 sketch.properties 或 main= 缺失时，仍回退到传统同名规则 |
| 命令行工具 | processing-java 的 --sketch= 参数仍指向文件夹，内部主程序解析逻辑应与 IDE 一致 |
| 导出/构建 | 导出的应用名称仍可能基于文件夹名，而非 main= 指定的文件名 |
| 社区工具链 | 部分第三方工具（如 VS Code 扩展 ）可能尚未适配此变更，仍强制检查同名约束 |
你的发现触及了 Processing 架构演进的一个关键点：从强约定（文件夹名=主程序名）转向弱约定+配置（sketch.properties 显式声明）。这是 Ben Fry 等核心开发者为了适应现代开发工作流（版本控制、持续集成、模块化开发）而做的妥协，同时保持了向后兼容性。
如果你需要进一步验证 main= 的具体语法（如是否需包含 .pde 扩展名、是否支持相对路径等），建议直接在 Processing 4.3+ 中实验，或查看 app/src/processing/app/Sketch.java 中 loadSketchProperties() 方法的源码实现。
Processing是一个老项目了，从2001年诞生，到现在已经有25个年头，很多技术理念需要与时俱进，我觉得它还是在尽力跟上这个日新月异的时代的。2026年，为Processing庆生~~~
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。