vscode本身不能运行.sb3文件，它只是编辑器而非scratch解释器；真正运行需克隆scratch-gui源码、执行yarn install和yarn start启动本地开发服务器，再访问http://localhost:8601调试。
VSCode 本身不能运行 .sb3 文件
这是最常被误解的点：VSCode 是编辑器，不是 Scratch 解释器。你拖进 VSCode 的 .sb3 文件只是 ZIP 压缩包（含 JSON、PNG、MP3），它不会自动执行，也不会在 VSCode 内部弹出舞台或积木界面。
真正能“运行”的，只有本地启动的 scratch-gui 开发服务器——它才是那个加载 .sb3 并渲染舞台、响应积木逻辑的程序。VSCode 只负责编辑源码、触发构建、配合调试。
- 不要试图右键
.sb3→ “Run Code” 或装插件一键运行——所有这类操作都无效 - 想快速预览单个
.sb3？直接用浏览器打开即可（拖入 Chrome/Firefox） - 想改积木行为、加新功能、调 UI 样式？必须走
scratch-gui源码开发流程
yarn start 报 “webpack-dev-server 不是内部或外部命令”
这不是 VSCode 的错，而是环境没对齐。这个错误只说明：终端当前不在 scratch-gui 项目根目录，或依赖没装全。
- 必须用
git clone https://github.com/LLK/scratch-gui.git下完整仓库，不能只下载单个.sb3或 zip 包 - VSCode 打开方式必须是 File → Open Folder…，选中
scratch-gui这个文件夹，不是单个文件 - 终端要确认路径：执行
pwd（macOS/Linux）或cd（Windows）看是否在项目根目录；ls package.json应该能列出 - 如果已全局装过
webpack-dev-server，反而可能冲突——删掉node_modules和yarn.lock，再跑yarn install
Windows 下 Node.js 环境变量配置失败
哪怕装了 Node.js，yarn 或 npm 命令仍报“不是内部或外部命令”，大概率是 PATH 没生效。
- 安装时务必勾选 Add to PATH（Node.js 官网安装包有此选项）
- 若跳过了，需手动添加两条路径到系统环境变量
Path：C:\Program Files\nodejs\和C:\Users\[用户名]\AppData\Roaming\npm - 改完环境变量后，**必须重启 VSCode 集成终端**（关掉再开），否则旧终端仍读不到新 PATH
- 验证：在 VSCode 终端里执行
node -v和yarn -v，两者都应返回版本号
哪些 VSCode 插件真有用，哪些纯属干扰
Scratch 二次开发本质是 React + Webpack 前端项目，不需要特殊语法支持，但需要基础工程能力。
- 必装：
ESLint（检查 JS/React 语法）、Prettier（统一格式）、Debugger for Chrome（配合http://localhost:8601断点调试） - 别装：
Scratch Language Support、SB3 Editor、Scratch Code Runner—— 它们只处理 .sb3 解析和简单预览，不参与源码构建，且会干扰 ESLint/Prettier 规则 - 不用配任何“Scratch 运行配置”：VSCode 的
launch.json对scratch-gui无意义，yarn start启动的是 Webpack Dev Server，不是 Node.js 脚本
yarn install → yarn start，之后浏览器打开 http://localhost:8601。所有改动都在 VSCode 里写，保存后页面自动热更新——这才是真正可调试、可扩展的 Scratch 开发闭环。其他路径，要么只能看，要么必然卡在第一步。
