# Arduino 入门 · Interactive 3D Course（第三方存档）

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

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

## 来源

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

## 它是什么

面向初学者的交互式 3D Arduino 课程。有课程、元件库、模拟器、串口监视器四大模块，教学 Arduino 基础（引脚、示例、规格）。3D 视图支持拖动/WASD 平移、Q/E 旋转、滚轮缩放。中文版在 `index.html`，22 种语言按需加载。

## 结构：Vite + 双层 chunk + 3D 引擎

```
index.html                          20 KB   入口 + 内联引导
assets/index--t3vAwvb.js            7 KB    ★ 引导 shim（只负责 modulepreload + 动态 import）
assets/main-J0C3NXDX.js           132 KB    ★ 真正主程序
assets/stage-SV6NgviM.js          425 KB    ★ 3D 舞台 + Three.js 引擎（WebGLRenderer 等）
assets/kit-Ce9DQFFx.js            317 KB    ★ 元件套件模型/逻辑
assets/thumbs-BJRYQS8w.js           5 KB    缩略图数据
assets/{22 种语言}-*.js            各数 KB   i18n 语言包（zh-DawrnNnG.js 等）
assets/index-D__-jKV9.css          82 KB    样式
assets/*.woff2                     50 个    字体（Barlow 系列）
favicon.ico/.svg / site.webmanifest / apple-touch-icon.png
```

⚠️ 注意这个"双层入口"：HTML 引的 `index--t3vAwvb.js` 只有 7KB，它 `import('./main-J0C3NXDX.js')` 才加载真正主程序；main 再引 stage/kit/thumbs。**这是 Vite 代码分割的典型形态**，也是最容易抓漏的地方。

## 技术拆解

| 层 | 实现 |
|---|---|
| 构建 | Vite 代码分割，入口 shim → 主程序 → 功能模块，多层动态 import |
| 3D 引擎 | Three.js（WebGLRenderer / BufferGeometry / PerspectiveCamera，在 stage chunk） |
| 多语言 | 22 种 i18n 独立 chunk，按需 import |
| 模拟器 | 页面含"模拟器""串口监视器"模块，靠 3D + JS 模拟 Arduino 行为 |
| 字体 | Barlow 系列本地 woff2，自托管 |
| 交互 | Drag/WASD 平移、Q/E 旋转、滚轮缩放 |

## 值得学的点

- **Vite 多层代码分割的落地形态**：shim → main → feature chunk，让首屏只下载最小引导，3D 引擎（425KB）和元件库（317KB）按需加载。这是大型前端应用优化首屏的经典套路，值得对照学习。
- **3D + 教学结合**：把电路板/元件做成可旋转缩放的 3D 模型，配合模拟器，是很好的硬件教学交互范式。
- **多语言架构**：22 种语言各自 chunk，切换时才加载，目录组织可直接借鉴。

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

- **所有 JS 都是压缩产物**，不可维护，当"成品参考"合适，当"代码教材"不合适。想改造需作者源码或反混淆。
- 3D 模型（Three.js 几何体）编译进 JS，改动成本高。
- 未开源、无许可，只作个人学习，别商用。

## 维护要点

- `_config.yml` 的 `skip_render` 里必须有 `"demo/**"`。
- `index.html` 里的 `/assets/...` 已改为 `./assets/...`；重抓上游后必须重改，否则 404 白屏。
- 双层 chunk 结构：若重抓，务必确认 `main-*.js`、`stage-*.js`、`kit-*.js` 都在，缺一个就白屏。
