如何设置VSCode以运行Processing代码并安装相应插件？

本文共计1091个文字，预计阅读时间需要5分钟。

`processing-java` 是用于执行 `.pde` 文件命令行工具。VSCode 本身不自带运行能力，必须依赖它来驱动。您安装的插件（如 TobiahZ 的 `Processing Language`）主要负责语法高亮、补全和错误提示，不负责运行——这是许多人一开始就会误以为的功能。

---

为什么按 Ctrl+Shift+B 没反应？

因为没配 tasks.json，或者配错了 command 路径：

• command 必须指向 processing-java 可执行文件，不是 Processing 安装目录，也不是 processing.exe
• Windows 下常见路径是：D:processing-4.3processing-java.exe（注意不是 processing.exe）
• macOS/Linux 下是：/Applications/Processing.app/Contents/Java/processing-java 或解压版里的同名文件
• 如果用了环境变量方式，command 应写成 ${config:processing.path}，但前提是已在 VSCode 设置里填对了 processing.path
• 别把 tasks.json 放在 Processing 安装目录下——它必须放在你的 Sketch 项目根目录 的 .vscode/ 文件夹里

---

tasks.json 里 args 怎么写才不报错？

关键参数顺序和平台差异容易翻车：

• --sketch=${fileDirname} 是必须的，表示当前 .pde 所在文件夹就是 Sketch 目录
• --run 要放在最后，否则 processing-java 会当成 sketch 名解析
• Windows 下路径分隔符用反斜杠 \，所以 --output=${fileDirname}\out；macOS/Linux 用正斜杠 /
• --force 建议保留，避免因上次编译残留导致失败
• 不要加 --output 参数除非你真要看 .class 文件——它会让启动变慢，且输出目录可能被防火墙拦截（尤其 Windows Defender）

精简可用版本（跨平台兼容）：

{ "version": "2.0.0", "tasks": [{ "label": "Run Sketch", "type": "shell", "command": "${config:processing.path}", "args": ["--force", "--sketch=${fileDirname}", "--run"], "group": {"kind": "build", "isDefault": true}, "presentation": {"panel": "dedicated"} }] }

---

插件提示“找不到 processing”或“command not found”

本质是 VSCode 找不到 processing-java，不是插件问题：

• 检查 processing-java 是否有执行权限（macOS/Linux 运行 chmod +x processing-java）
• 在终端里手动执行一遍：./processing-java --sketch=/path/to/your/sketch --run，看是否报错
• 如果报 Java version too old，说明 Processing 4.x 需要 Java 17+，而系统默认可能是 Java 8/11；此时 processing.path 应设为 Java 17 的 java 路径，并改用 -jar 方式调用（见下条）
• Processing 4.3+ 推荐用 Java 直接运行 jar：command 改成 java，args 改为 ["-jar", "/path/to/processing-java.jar", "--sketch=...", "--run"]

---

运行后窗口闪退或黑屏？

多数是 setup() 里出错，但错误被静默吞掉：

• 去掉 --run，只留 --force --sketch=...，让它只编译不运行，然后去 out/ 目录看有没有生成 .class 文件
• 打开终端面板（Ctrl+`），手动进项目目录执行 processing-java --sketch=. --verbose --run，--verbose 会打印 JVM 启动日志和异常堆栈
• 常见原因：用了 P3D 渲染器但显卡驱动不支持；size() 参数传了 0 或负数；loadImage() 路径写错且没做 null 判断
• VSCode 插件的“实时预览”功能（如 Ctrl+Alt+R）依赖本地服务器，若端口被占或浏览器禁用了本地 file:// 协议，也会白屏

真正卡住的地方往往不是配置步骤，而是 processing-java 和 Java 版本、图形驱动、路径权限这三者的隐式耦合——它不报明确错误，只沉默失败。调试时优先切到终端手动跑命令，比在 VSCode 里点来点去快得多。