把数写进链接
每个参数都是网址参数，下面这个链接打开的就是示例那一件。ChatGPT、Claude、豆包这类助手照着参数表就能写出这样的链接——参数表（名称、单位、范围）在： 参数表（JSON）
ESP32 外壳生成器：15 款 ESP32 开发板的 3D 打印外壳，按板子外形卡住
选你的开发板——默认 30 针 DOIT ESP32 DevKit V1——得到上下两件式外壳：板子放进底壳的卡槽，上盖的压筋停在模组屏蔽罩和 USB 外壳上方 0.3 mm，四颗 M3 沉头螺丝从上面拧紧。板子靠外形固定，不靠安装孔：乐鑫的 DevKitC 板没有安装孔，DOIT 兼容板的孔位在不同来源之间能差 1.4 mm。再选排针朝下、不焊排针还是插着杜邦线，底壳就在板下留出对应的空间。
直接在这里用
真正的生成器就在你的浏览器里运行：调好参数，点下载按钮导出 STEP 或 STL。不用安装，不用注册。
第一次打开会下载约 20 MB 的 CAD 内核。
- - 15 款板子：DOIT DevKit V1、ESP32-DevKitC V4、ESP32-S3 / C6 / C3 官方 DevKit、YD-ESP32-S3、C3 SuperMini、S3-Zero、四款 Seeed XIAO、Arduino Nano ESP32、LilyGO T-Display-S3、ESP32-CAM
- - 按板子外形做卡槽、每边 0.3 mm，上盖压筋压住——没有要剪掉的定位柱
- - 板下空间一项选好：已焊排针，或插着杜邦线
- - USB 开孔按插头大小，按键上方开孔，有摄像头、屏幕、SD 卡的板子就开对应的窗
- - 可选出线槽或 PG7 防水接头孔、安装耳、上盖散热孔
可调参数
以下参数在生成器里逐项可调，每次修改都会重建真实几何——不是缩放网格。
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 开发板BOARD | ESP32 DevKit V1 | 15 boards (table below) | 默认 30 针 DOIT DevKit V1：MakerWorld 上下载最多的 ESP32 外壳都是给这类 DevKit 板做的。每块板的外形、排针、天线、接口和按键都取自它自己的数据，见下表。 |
| 板下空间PINS | Pins soldered | pins down / no pins / jumper wires | 多数板子出厂就焊好排针、针脚朝下；针尖最深到板下 8.54 mm，底壳再多留 1 mm。选杜邦线，就再给 14 mm 长的杜邦头和 5 mm 的线弯留空间。不焊排针，外壳最薄。 |
| 装配间隙FIT | 0.3 mm | 0.1 – 1 | 板子和卡槽之间每边的间隙。0.3 取自 YAPP 外壳库 ESP32-CAM 盒子的余量；用紧的外壳时，有人放大到 101–110 % 才装得下兼容板。你的板子偏大就调大。 |
| 壁厚WALL | 2 mm | 1.2 – 3 | 2 mm，和热门外壳一样（YAPP 2.0、开源的 C3 SuperMini 外壳 2）；1.2 是三圈 0.4 mm 的外墙。 |
| 天线端留空ROOM | 2 mm | 0 – 15 | 模组天线那一端外面留的空，整个宽度都空。热门外壳只留 0.3–1 mm，有用户要求再多 1–2 mm；15 是乐鑫建议外壳内天线周围留的净空。 |
| 出线口WIRE_EXIT | None | none / slot / PG7 | 开在远端端面：从底到分模线的 5.5 mm 槽（三根 20 AWG 线，杜邦头也能穿过），或 12.8 mm 的 PG7 防水接头孔，内部留出锁紧螺母的位置。ESP32-CAM 总是带出线槽：它靠排针供电。 |
| 安装耳EARS | off | on / off | 两条长边贴地各一个 3 mm 厚的安装耳，带 M3 沉头孔，用来固定在墙上或面板上。默认关，放在桌上没有凸出的部分。 |
| 上盖散热孔VENTS | on | on / off | 上盖上横向的 2 mm 条形孔，避开压筋、开窗和按键孔。默认开：有 ESP32-CAM 用户反映闪光灯「发热很厉害」。 |
每个参数都能写进网址，一个链接就能打开你要的那一件。 示例（DevKitC V4 外壳：板下插得下杜邦线，端面出线槽，带安装耳）：https://www.forgent3d.com/zh/generators/esp32-case-generator?BOARD=ESP32-DevKitC+V4&PINS=Jumper&WIRE_EXIT=Slot&EARS=true
15 款开发板和它们的外壳
每款外壳都按默认值（间隙 0.3、壁厚 2、天线端留空 2、无出线口），单位 mm；高度是底壳加上盖，依次为排针朝下 / 不焊排针 / 插杜邦线。只有几何数据是真的板子才进列表：我们实测过的厂商 CAD（STEP 或 DXF）、官方图纸，或者兼容板至少两个互相独立且一致的来源——卡槽覆盖它们之间的差异。点每一行直接打开那块板的外壳。
| 开发板 | 板子数据来源 | 外壳外廓 | 螺丝柱外廓 | 高度 | 螺丝 | |
|---|---|---|---|---|---|---|
| ESP32 DevKit V1（DOIT 30 针） | 兼容板：含全部元件的 STEP，外形取五个来源（51.4–52.0 × 27.9–28.5），卡槽覆盖这个范围 | 58.6 × 33.1 | 65.5 × 40.0 | 21.6 / 17.1 / 33.6 | 4 × M3 × 16 | 打开 → |
| ESP32-DevKitC V4（38 针） | 乐鑫尺寸 DXF 和 PCB 布局图（板底无元件）；接口高度取自其他板子的 STEP | 60.9 × 32.5 | 67.8 × 39.5 | 21.6 / 17.1 / 33.6 | 4 × M3 × 16 | 打开 → |
| ESP32-S3-DevKitC-1 | 乐鑫尺寸 DXF 和 PCB 布局图（板底无元件）；接口高度取自其他板子的 STEP | 75.8 × 30.0 | 82.7 × 37.4 | 21.6 / 17.1 / 33.6 | 4 × M3 × 16 | 打开 → |
| YD-ESP32-S3（N16R8 44 针） | 厂家图纸和一份独立的 STEP，两者一致；USB-C 开孔同时覆盖两者 | 70.0 × 32.5 | 76.9 × 39.5 | 20.5 / 17.1 / 32.5 | 4 × M3 × 16 | 打开 → |
| ESP32-C3 SuperMini | 兼容板：卖家图纸和社区 STEP；卡槽能放下长 1.5 mm 以内的板子 | 30.6 × 22.6 | 37.6 × 29.5 | 21.0 / 17.1 / 33.0 | 4 × M3 × 16 | 打开 → |
| ESP32-C6-DevKitC-1 | 乐鑫尺寸 DXF 和 PCB 布局图（板底无元件）；接口高度取自其他板子的 STEP | 64.8 × 30.0 | 71.7 × 40.2 | 21.0 / 17.1 / 33.0 | 4 × M3 × 16 | 打开 → |
| ESP32-C3-DevKitM-1 | 乐鑫尺寸 DXF 和 PCB 布局图（板底无元件）；接口高度取自其他板子的 STEP | 50.9 × 30.0 | 57.9 × 36.9 | 21.6 / 17.1 / 33.6 | 4 × M3 × 16 | 打开 → |
| 微雪 ESP32-S3-Zero | 微雪图纸和 STEP | 30.1 × 22.6 | 37.0 × 29.5 | 20.6 / 17.1 / 32.6 | 4 × M3 × 16 | 打开 → |
| Seeed XIAO ESP32S3 | Seeed STEP 和 DXF（外接 u.FL 天线） | 27.7 × 22.4 | 34.7 × 29.3 | 20.2 / 17.1 / 32.2 | 4 × M3 × 16 | 打开 → |
| Seeed XIAO ESP32S3 Sense | Seeed 摄像头组件 STEP；摄像头从上盖伸出 3.76 mm；不开 microSD 口（STEP 里没有卡槽） | 30.9 × 22.4 | 37.8 × 29.3 | 22.5 / 17.1 / 34.5 | 4 × M3 × 16 | 打开 → |
| Seeed XIAO ESP32C6 | Seeed 官方 STEP 和 KiCad PCB | 27.6 × 22.4 | 34.5 × 29.3 | 20.2 / 17.1 / 32.2 | 4 × M3 × 16 | 打开 → |
| Seeed XIAO ESP32C3 | 社区 STEP，已对照 Seeed KiCad PCB；板厚未公布，外壳按 1.25 做 | 27.6 × 22.4 | 34.5 × 29.3 | 20.2 / 17.1 / 32.2 | 4 × M3 × 16 | 打开 → |
| Arduino Nano ESP32 | Arduino STEP 和规格书 | 49.8 × 22.4 | 56.7 × 29.3 | 20.8 / 17.1 / 32.8 | 4 × M3 × 16 | 打开 → |
| LilyGO T-Display-S3 | LilyGO PCB 和整板 STEP；屏幕玻璃上方开窗 | 67.4 × 30.5 | 74.3 × 37.5 | 20.6 / 17.1 / 32.6 | 4 × M3 × 16 | 打开 → |
| ESP32-CAM（安信可） | 安信可图纸和社区 STEP；卡槽覆盖 40–40.5 的长度差异 | 47.1 × 31.6 | 54.0 × 38.5 | 23.7 / 21.1 / 35.7 | 4 × M3 × 20 | 打开 → |
板厚没有公布的板子，外壳按 1.6 mm 做，即实测范围的上限：薄一些的板子会稍低，压筋下最多约 0.7 mm 的晃动，但绝不会压坏板子。选 PG7 防水接头时，上盖加高放锁紧螺母，螺丝可能变长（DevKit V1：M3 × 20，高 23.6 mm）。
STEP 文件里是什么
- - 默认外壳（ESP32 DevKit V1）导出为两个精确实体（底壳和上盖），共 149 个面：121 个平面、24 个真圆柱面（螺丝过孔和底孔、四角螺丝柱、按键孔、卡槽圆角）、4 个圆锥面（M3 沉头），没有样条曲面。每个开孔、卡槽壁和螺丝孔在 CAD 里都能直接量出来——要自己加安装座或开孔，就从这份 STEP 开始。
- - ESP32-CAM 外壳是 159 个面：126 个平面、29 个圆柱面、4 个圆锥面。
STEP AP214，毫米单位，精确 B-rep——能直接在 SolidWorks、Fusion、FreeCAD、Onshape、Inventor 里打开，也能直接交给 CNC 报价。打印用的 STL 也一样能导。
和其他做法比
| 本生成器 | 常见在线 STL 生成器 | 厂商 CAD 模型库 | |
|---|---|---|---|
| 范围内任意尺寸 | 可以 | 可以 | 只有目录规格 |
| 精确曲面的 STEP | 有 | 多数只给 STL 网格 | 有 |
| 滑块覆盖不到的改动 | 页面上「AI 修改」 | 不行 | 不行 |
| 下载要注册 | 不用 | 多数不用 | 常常要 |
让 AI 接着改
在页面上用 AI 改
在生成器里点「AI 修改」，说要改什么——加键槽、开孔、换个形状。AI 直接改零件的 model.py，在你的浏览器里重建，改坏了能撤销。未登录每天也能免费改几次；要保存、要多轮修改，就复制到你的模型里，交给 AI agent。
用 AI 修改 →在工作台里接着改
改动大、要改好几轮、或者要长期留着：复制到你的模型（免费注册），Forgent3D 的 AI agent 读这份 model.py、改它、重建并自己检查结果。
复制并用 AI agent 继续 →怎么用
- 1.打开生成器，模型在浏览器里完成首次构建（无需安装任何软件）。
- 2.在参数面板里调整尺寸与选项，几何实时重建、随时 3D 预览。
- 3.导出 STL / STEP 去打印；或让 AI agent 在同一模型上加参数外的特征。
常见问题
为什么板子放在卡槽里，而不是用定位柱或螺丝固定？
乐鑫的 DevKitC 板没有安装孔，DOIT 兼容板的孔位在不同来源之间能差 1.4 mm。MakerWorld 上下载最多的 ESP32 外壳，至少 12 条评论说得把定位柱剪掉。所以卡槽按板子外形做、每边留 0.3 mm，板子底面空着的地方有支撑垫，上盖下的压筋把它压住。你的兼容板偏大一点，就把装配间隙调大——用别的外壳时，有人要放大到 101–110 %。
焊了排针、或者插着杜邦线，装得下吗？
多数板子出厂就焊好排针、针脚朝下，所以这是默认：针尖到板下 8.54 mm，底壳再多留 1 mm。别的外壳下常见的抱怨是「板下没地方插杜邦线」——选「排针上插杜邦线」，底壳会给 14 mm 长的杜邦头和 5 mm 的线弯留出空间（DevKit V1 总高 33.6 mm）。XIAO、C3 SuperMini、S3-Zero、Nano ESP32、T-Display-S3 出厂没有焊排针；选「不焊排针」外壳最薄。
外壳会影响 Wi-Fi 吗？
我们没有测过，页面也不对信号做任何承诺。乐鑫的硬件设计指南建议：外壳内 PCB 天线四周各方向至少留 15 mm 净空，并且成品要实测吞吐量和通信距离。「天线端留空」最多能在天线那一端外面留 15 mm，整个宽度都空（ESP32-S3-DevKitC-1 的外壳从 75.8 mm 长到 88.8 mm）；两侧仍是卡槽壁。在热门 ESP32 外壳的约 1,000 条评论里，我们没找到抱怨信号的；和天线有关的抱怨都是板子装不进去。
用什么螺丝、什么材料？
四颗 M3 沉头螺丝（ISO 10642 / DIN 7991）从上盖往下拧进底壳的自攻底孔：除 ESP32-CAM 用 M3 × 20 外，其他板子都是 M3 × 16（加 PG7 防水接头也可能变长）。生成器会选在底壳里留够 6 mm 螺纹的最短标准长度。和热门外壳一样打：PLA 或 PETG、0.2 mm 层高、不用支撑——底壳底面朝下、上盖顶面朝下，就按打印板上摆好的方向；只有散热孔和开窗处是搭桥。ESP32-CAM 请用 PETG。
ESP32-CAM 外壳能连 CAM-MB 下载底板一起装吗？
不能。ESP32-CAM-MB 没有 CAD 文件也没有图纸，只有互相对不上的商品尺寸（40 × 27 × 10、39.8 × 27、40 × 25），所以外壳是给单独一块、靠排针供电的板子做的，并且总带出线槽走这几根线。烧录请在外壳外面插 MB 底板进行。
为什么没有我的 ESP32 板子？
只有几何数据是真的板子才进列表：厂商 CAD、官方图纸，或两个互相独立且一致的来源。暂时没有：38 针 USB-C 兼容板（没有 CAD，长度 48.26 到 51 mm 不等）、USB-C 版 DOIT DevKit V1、ESP32-S3 SuperMini、NodeMCU-32S、LOLIN mini 系列（接口没标尺寸）、初代 LilyGO T-Display，以及 Freenove、M5Stack 的摄像头板。可以选最接近的板子，再用「AI 修改」改成你的。ESP32 是乐鑫科技的商标，各板子名称归其厂商所有；这个生成器做的是兼容外壳，与它们没有关联。
这个外壳实际打印验证过吗？
还没有。有厂商或社区 STEP 文件的 11 块板（除四款乐鑫 DevKit，它们只有 DXF 图纸）都放进外壳里检查过，和底壳、上盖零干涉；每块板、每种板下空间都过了 14 项自动检查——但还没有实际打印。还要在实物上确认：每块板 0.3 mm 间隙的松紧；薄板在压筋下会不会晃（用户自己的办法是点一点热熔胶）；M3 螺丝在打印底孔里自攻；回形针能不能按到按键；ESP32-CAM 的镜头槽、闪光灯窗和 SD 卡；XIAO Sense 的摄像头窗；T-Display-S3 的玻璃压边；真插头插进开孔；PG7 防水接头；以及隔着外壳的 Wi-Fi。
ESP32-CAM 的外壳怎么 3D 打印？
打开 https://www.forgent3d.com/zh/generators/esp32-case-generator?BOARD=ESP32-CAM 就是：安信可 ESP32-CAM 的上下两件式外壳——镜头上方开槽（离 SD 卡那端 9 到 10.5 mm，覆盖三个来源给的镜头位置），闪光灯开窗，microSD 卡从端面插拔，底部开复位键孔，还有出线槽，因为这块板靠排针供电。螺丝柱外廓 54.0 × 38.5 mm，高 23.7 mm，四颗 M3 × 20 沉头螺丝合上。请用 PETG 打印：有用户反映闪光灯把 PLA 外壳烤软了。不支持 ESP32-CAM-MB 下载底板。
想要一个能用螺丝挂墙、带 PG7 防水接头孔的 ESP32 DevKit 外壳？
可以：https://www.forgent3d.com/zh/generators/esp32-case-generator?BOARD=ESP32%20DevKit%20V1&WIRE_EXIT=PG7&EARS=true ——30 针 DOIT DevKit V1 外壳，远端端面开 12.8 mm 的 PG7 防水接头孔，内部留出对边最大 19.05 mm 的锁紧螺母空间；两条长边各有一个带 M3 沉头孔的安装耳，孔距 44.1 mm。为放下锁紧螺母，上盖会加高：总高 23.6 mm，用四颗 M3 × 20 螺丝。外壳有散热孔和螺丝合缝，本身不密封、不防水。
生成的模型可以商用吗？
可以。用生成器做出来的模型和导出的 STL / STEP 文件归你所有：自己打印、出售打印件、在产品里使用都没有限制，也不需要署名 Forgent3D。
更多生成器
已经有自己的 .scad 文件？ OpenSCAD 转 STEP → · 在浏览器里预览 →