Ubuntu 20.04下运行Processing Sketch报错求助（VS Code/终端）

问题背景 #

• 系统：Ubuntu 20.04
• 已部署processing-java至路径/opt/processing-4.0.1/processing-java
• 使用官网提供的2D数组示例草图，在Processing IDE中可正常运行，但通过命令行或VSCode插件运行时，抛出如下错误：

Exception in thread "main" java.lang.ArrayIndexOutOfBoundsException: Index 0 out of bounds for length 0
    at processing.app.Sketch.getMainName(Sketch.java:1699)
    at processing.mode.java.JavaBuild.preprocess(JavaBuild.java:144)
    at processing.mode.java.JavaBuild.build(JavaBuild.java:110)
    at processing.mode.java.Commander.<init>(Commander.java:233)
    at processing.mode.java.Commander.main(Commander.java:417)

解决步骤 #

1. 规范草图文件结构 #

Processing命令行工具对文件结构有严格要求：

• 新建一个与草图同名的文件夹，比如将示例草图命名为Array2D，则创建文件夹Array2D
• 将草图代码保存为Array2D.pde，放入该文件夹内
• 确保文件夹内仅包含该.pde文件（或符合Processing项目规范的辅助文件）

2. 修正命令行参数 #

运行命令时，--sketch参数必须指向草图文件夹的正确路径（绝对路径或相对路径均可，确保工具能找到目标文件夹）：

# 使用绝对路径示例
/opt/processing-4.0.1/processing-java --sketch=/home/你的用户名/sketches/Array2D --output=~/Desktop/Array2D_output --force --run

# 如果当前工作目录是草图文件夹的上级目录，可使用相对路径
/opt/processing-4.0.1/processing-java --sketch=./Array2D --output=~/Desktop/Array2D_output --force --run

注意：--output指定的输出目录建议独立，避免覆盖现有文件，--force参数会强制清空并重建输出目录。

3. VSCode插件配置调整 #

若使用VSCode的Processing插件：

• 在插件设置中指定processing-java的路径为/opt/processing-4.0.1/processing-java
• 确保VSCode工作区打开的是包含.pde文件的草图文件夹，而非上级目录

错误原因解析 #

该异常由Sketch.getMainName()方法抛出，本质是processing-java无法识别有效的草图主文件，常见诱因：

• 草图文件夹名称与.pde文件名不匹配
• --sketch参数指向的路径错误，工具找不到目标文件夹
• 目标文件夹内无.pde文件，或存在多个不符合规则的.pde文件

内容的提问来源于stack exchange，提问作者Lenn