3MF 示例文件 — 下载 3D Manufacturing Format 测试文件
3MF — 3D 制造格式 · .3mf · MIME 类型 model/3mf
下载 3MF 示例文件，用来测试切片软件或打印服务的集成。一个文件包含一个可直接打印的 L 形支架（40 × 20 × 24 mm，614 个三角形），并带有 PNG 包缩略图；另一个包含三个独立对象——立方体、球体和圆柱体——每个都在 basematerials 组中定义了自己的显示颜色。
3MF 是 3D 打印联盟为取代 STL 而制定的格式。它是一个 ZIP（OPC 包），包含 [Content_Types].xml、_rels/.rels 以及位于 3D/3dmodel.model 的 XML 模型；与 STL 不同，它会明确记录单位、颜色、多个对象以及在打印平台上的摆放位置。两个文件均以毫米为单位、Z 轴朝上，模型封闭且为二维流形（2-manifold）。
下载 3MF 示例文件
| 文件 | 详情 | 大小 | 下载 |
|---|---|---|---|
sample-bracket-single-object.3mf | 614 个三角形 · 303 个顶点 · 1 种材质 · 毫米，Z 轴朝上 | 14 KB | |
sample-multi-object-colors.3mf | 2,248 个三角形 · 1,130 个顶点 · 3 个对象 · 3 种材质 · 毫米，Z 轴朝上 | 23 KB |
在命令行或 CI 中使用这些文件
每个 URL 都稳定不变并开放 CORS。在测试中固定 SHA-256，一旦测试夹具发生变化，你会立刻知道。
# 下载单个文件 curl -O https://pnb-freetoolsforweb.s3.us-east-2.amazonaws.com/samples/3d/3mf/sample-bracket-single-object.3mf # 校验文件（上方每个文件都列出了 SHA-256） shasum -a 256 sample-bracket-single-object.3mf # 所有示例文件的机器可读索引 curl https://pnb-freetoolsforweb.s3.us-east-2.amazonaws.com/samples/index.json | jq '.files[] | select(.format=="3mf")'
3MF 格式概览
| 全称 | 3MF — 3D 制造格式 |
|---|---|
| 扩展名 | .3mf |
| MIME 类型 | model/3mf |
| 规范 | 3MF 核心规范（3D Manufacturing Format） |
| 容器 | ZIP / 开放打包约定（OPC） |
| 模型部件 | 3D/3dmodel.model（XML，核心命名空间 2015/02） |
| 单位 | 在文件中声明：unit="millimeter" |
| 颜色 | basematerials 配合 displaycolor（sRGB + Alpha） |
用 3MF 示例文件测试什么
- 切片软件和打印农场的上传处理
- 读取包缩略图用于预览
- 多对象和多颜色导入
- 单位处理（不再纠结“到底是毫米还是英寸”）
- ZIP + XML 解析的健壮性
- STL 转 3MF 的转换检查
常见问题
3MF 比 STL 更好吗？
就打印而言，是的。它体积更小（经过压缩），声明了单位，支持颜色、材质和多个对象，还记录了每个零件在打印平台上的位置。不过老工具对 STL 的支持仍更广泛，所以大多数服务两种都接受。
如何打开 3MF 文件？
PrusaSlicer、Bambu Studio、Cura 等切片软件都能直接导入，three.js 也提供 3MFLoader。由于它是 ZIP，你也可以把副本改名为 .zip，自己查看里面的 XML。
这些文件使用什么单位和朝上轴？
glTF、GLB、OBJ、PLY、OFF、DAE 和 USDZ 为 Y 轴朝上、单位为米（环面结直径约 1.4 m）。STL 和 3MF 为 Z 轴朝上、单位为毫米，并按切片软件的习惯放置在 z = 0 上。FBX 为 Y 轴朝上、单位为厘米。每个文件的单位和朝上轴都列在其详情中，方便你检查导入器的缩放和旋转是否正确。
这些模型是从哪里来的？
由我们自己生成。脚本先用公式构建几何体（环面结、UV 球、立方体，以及用布尔建模库制作的支架），再按各格式规范逐字节写出文件。没有任何模型是下载、扫描或从他人模型转换而来的，因此可免费用于任何用途（包括商业用途），无需署名。
下载这些 3MF 文件安全吗？
安全。每个文件都由我们自己的开源脚本从零生成——没有抓取或用户上传的内容——不包含脚本、宏或可执行文件。本页公布了每个文件的 SHA-256，方便你校验收到的文件。
可以将这些 3MF 示例文件用于商业用途吗？
可以。它们可免费用于任何用途，包括商业产品、测试套件、演示和再分发，无需署名。不需要任何授权，也不必征求任何人的同意。
可以直接外链这些文件或在 CI 中使用吗？
可以。每个链接都是稳定的 HTTPS 直链，带有 Access-Control-Allow-Origin: * 和较长的缓存头，curl、wget、fetch() 和测试运行器都可以直接拉取。每个页面都链接了所有文件的 JSON 索引（见命令行部分）。
相关示例文件
支持 3MF 的免费工具
发现问题，或者觉得哪里可以更好？每条消息我们都会阅读，并尽快修复。