# Learn ESP32 · Interactive 3D Lessons（第三方存档）

御坂 2026-11-19 收录，用于日后学习/改造参考。

> 别人的作品，作者 **Dilum Sanjaya**（x.com/DilumSanjaya），**不是本站原创、未开源**。统一入口见 `../index.html`。

## 来源

| 项 | 值 |
|---|---|
| 原地址 | `https://learn-esp32.vercel.app/` |
| 抓取日期 | 2026-11-19 |
| 作者 | Dilum Sanjaya（页面署名） |
| 许可 | 未找到开源许可声明 |
| 运行方式 | 纯静态，任意 HTTP 服务即可 |
| 归档体积 | 约 3.2 MB |

## 它是什么

ESP32 交互式 3D 课程。含课程、元件、参考、原理图（Schematic）、引脚图（Pinout）、示例、规格，以及"动手试试"和串口监视器（Serial monitor）。3D 交互同系列。22 种语言。

## 结构：Vite + 主程序 + 3D + 多语言

```
index.html                          23 KB   入口
assets/index-DkuYVBNg.js           163 KB   主程序
assets/index-D92WvK9w.css           70 KB   样式
assets/{22 种语言}-*.js            各数 KB  i18n 语言包（zh-9PbFRrCs.js 等）
assets/*-场景/模型 chunks            —       3D 场景/模型
assets/*.woff2                      26 个   字体
favicon / site.webmanifest / png
```

这一站的 chunk 抓得最完整（递归补抓后 0 缺失），是四站里结构最干净的。

## 技术拆解

| 层 | 实现 |
|---|---|
| 构建 | Vite，单主程序 + 动态 chunk |
| 3D 引擎 | Three.js（WebGLRenderer / BufferGeometry / PerspectiveCamera） |
| 多语言 | 22 种 i18n 独立 chunk，按需加载 |
| 硬件教学 | Schematic / Pinout / Specifications / Example 多维度呈现 ESP32 |
| 交互实验 | "Try it yourself" + Serial monitor 模拟 |
| 字体 | 本地 woff2 自托管 |

## 值得学的点

- **硬件教学的多维度呈现**：同一块 ESP32 开发板，从引脚图、原理图、规格、示例多个角度讲，配合 3D 模型——比单一视角教学信息密度高，值得借鉴。
- **串口监视器模拟**：在浏览器里模拟 Arduino/ESP32 的串口输出，是硬件教学前端化的关键技巧。
- **22 语言 i18n**：语言包完整，是四站里做国际化最全的。

## 局限（别照抄的地方）

- 压缩 JS 不可维护，只作成品参考。
- 与 Arduino / Electronics 101 高度同质化，改造价值有限，主要看"换内容不换框架"的思路。
- 未开源、无许可，别商用。

## 维护要点

- `_config.yml` 的 `skip_render` 里必须有 `"demo/**"`。
- `index.html` 里的 `/assets/...` 已改为 `./assets/...`；重抓上游后必须重改。
- 带哈希的 assets 文件名不要改。
