讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

如何将sb3文件转换成html

浅枫大大_3563

浅枫大大_3563

发布时间:2026-02-12 20:31:02

|

786人浏览过

|

来源于php中文网

原创

.sb3文件本质是ZIP压缩包,解压后需保留哈希命名的资源文件和原目录结构,并通过本地HTTP服务运行含scratch-gui的HTML页面加载project.json。

如何将sb3文件转换成html

sb3 文件本质是 zip 压缩包,直接解压就能拿到 HTML 所需资源

Scratch 3.0 的 .sb3 文件不是黑盒,它就是一个标准的 ZIP 归档,里面包含 project.json、音频、图像、SVG 等资源。所谓“转成 HTML”,其实是把项目运行所需的全部内容组织起来,用一个 HTML 页面加载 Scratch VM 运行时来执行它。

关键点在于:你不能只提取文件就完事——project.json 里记录的是资源的哈希路径(比如 "md5ext": "abc123.png"),而解压后文件名就是那个哈希名,必须原样保留;否则运行时找不到素材,会白屏或报错 Failed to load resource。

  • 用系统自带解压工具或 unzip 命令解压,别用某些压缩软件“自动重命名中文/特殊字符”
  • 解压后目录结构必须保持原样:project.json 在根目录,所有 *.png、*.wav 等都在同一层
  • 不要手动改 project.json 里的 md5ext 字段——改了就和文件名对不上

用官方 scratch-gui 启动本地 sb3 需要起一个本地服务

浏览器出于安全策略,禁止从 file:// 协议直接加载 project.json(会触发 CORS 错误,控制台报 Access to XMLHttpRequest at 'file:///...' from origin 'null' has been blocked)。所以必须用 HTTP 服务打开 HTML 页面。

最轻量的做法是用 Node.js 的 http-server 或 Python 内置模块,不装任何构建工具:

立即学习“前端免费学习笔记(深入)”;

  • Node 用户:先全局安装 http-server(npm install -g http-server),进到解压后的目录,运行 http-server -p 8080
  • Python 3 用户:进目录后运行 python3 -m http.server 8080
  • 访问 http://localhost:8080 就能看到空白页面——还没加 HTML 入口

最小可用 HTML 文件只需加载 scratch-gui + 指定 sb3 路径

Scratch 官方提供了可离线运行的 scratch-gui 构建产物,不需要自己编译。你只需要一个 HTML 文件,引入它的 JS/CSS,并告诉它加载哪个 project.json。

DeepBI DHTML 页面生成器
DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur

下载

去 GitHub releases 页面 下载最新版 scratch-gui-v*.zip(比如 scratch-gui-v3.27.0.zip),解压后把里面的 build/ 整个文件夹复制到你的 sb3 解压目录下(同级)。

然后在该目录新建一个 index.html:

<!DOCTYPE html>
<html>
<head><meta charset="utf-8"></head>
<body style="margin:0">
  <div id="app"></div>
  <script src="build/static/js/main.f9e4d6c1.js"></script>
  <script>
    window.scratchGuiOptions = {
      projectUrl: './project.json'
    };
  </script>
</body>
</html>

注意:main.f9e4d6c1.js 名字每次 release 都不同,得按你下载的 build/static/js/ 里实际文件名改;projectUrl 必须是相对路径,且指向解压出的 project.json。

常见失败原因:跨域、路径错、资源缺失、版本不匹配

跑不起来?八成卡在这几个地方:

  • 没起本地服务,直接双击 index.html → 浏览器报 CORS 或 net::ERR_FILE_NOT_FOUND
  • projectUrl 写成 './project.json?time=123' 这类带查询参数的 → Scratch GUI 不识别,静默失败
  • 音频文件是 .mp3 但浏览器不支持(尤其 Safari),换成 .wav 或 .ogg 更稳妥
  • 用了较新的 Scratch 功能(如自定义渲染器、新扩展),但下载的 scratch-gui 版本太旧 → 检查 project.json 顶部的 runtimeVersion,选对应 release
  • 解压时把 project.json 放进了子文件夹(比如 my-project/project.json)→ projectUrl 得同步改成 './my-project/project.json',且所有资源也得在 my-project/ 下

真正麻烦的不是转换动作本身,而是路径和权限这两个隐形关卡——它们不报错,只让画面停在加载动画,或者角色不动、声音不响。多看浏览器开发者工具的 Network 和 Console 标签页,比反复重试更省时间。

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2355

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3902

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1296

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4539

2025.09.10

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

569

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1698

2024.03.01

resource是什么文件
resource是什么文件

Resource文件是一种特殊类型的文件,它通常用于存储应用程序或操作系统中的各种资源信息。它们在应用程序开发中起着关键作用,并在跨平台开发和国际化方面提供支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

320

2023.12.20

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

5076

2023.06.20

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 244人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn