VSCode 的 Processing 插件仅提供语法支持，必须配合本地完整 PDE 安装，并在 settings.json 中显式配置 processing.path 指向解压后的 Processing 根目录（如 C:\tools\processing），且 sketch 必须为同名文件夹内含同名 .pde 文件。
VSCode 本身不原生支持 Processing，必须通过插件桥接 PDE（Processing Development Environment）才能运行代码；直接装插件不配置路径会报 command 'processing.run' not found 或找不到 processing-java。
Processing 插件必须配合本地 PDE 安装才能工作
VSCode 的 Processing Language Support 插件（由 kisstkondoros 开发）只是语法高亮 + 代码补全，真正执行依赖你本机已安装的 Processing。它不是独立运行时，而是调用 PDE 自带的 processing-java 命令行工具。
- 必须先从 processing.org/download 下载完整版（如
processing-4.3-windows64.zip），解压后保留整个文件夹结构 - 不能只复制
processing.exe或仅提取 jar 包——插件需要访问core/library/、java/bin/等子目录 - 推荐解压到固定路径，例如
C: oolsprocessing，避免空格和中文路径（否则processing-java启动失败）
vscode settings.json 中必须显式配置 processing.path
插件默认不会自动探测 Processing 安装位置，必须手动在 VSCode 全局或工作区 settings.json 中写死路径，否则所有运行/编译操作都会静默失败。
- 打开 VSCode 设置（Ctrl+,），切换到“文本编辑器”→“设置”右上角点击“打开 settings.json”
- 添加如下字段（路径按你实际解压位置修改）：
"processing.path": "C:\tools\processing"
- Windows 路径需用双反斜杠
\或正斜杠/，不可用单反斜杠（JSON 解析会出错） - 如果用的是 portable 版本（即解压即用无安装），确保该路径下存在
processing-java.bat（Windows）或processing-java（macOS/Linux）
Processing 文件必须保存为 .pde 后缀且位于 sketch 文件夹内
Processing 对项目结构有硬性约定：一个 sketch 是一个**文件夹**，主代码文件名必须与文件夹同名 + .pde 后缀。VSCode 插件严格校验此结构，否则右键“Run Sketch”灰色不可点。
- 正确结构示例：
my-sketch/<br>├── my-sketch.pde ← 文件名必须和文件夹名一致<br>└── data/<br> └── image.png
- 错误做法：直接新建
test.pde放在桌面或任意平级目录——插件无法识别为合法 sketch - VSCode 中新建 sketch 推荐用命令面板（Ctrl+Shift+P）→ 输入
Processing: Create New Sketch，它会自动创建带正确命名的文件夹和文件 - 若已有旧 sketch，确保文件夹名不含空格、括号、点号等 shell 不友好字符（如
hello-world.pde可能导致processing-java解析失败）
最容易被忽略的是 sketch 文件夹名与主文件名的严格一致性——哪怕大小写差一个字母，或者多一个下划线，processing-java 就会拒绝加载，且 VSCode 插件不报具体错误，只显示“Running…”然后卡住。建议用命令面板创建新 sketch 养成习惯，比手动调整更可靠。
