OBJ 示例文件 — 下载带 MTL 和贴图的 OBJ 测试文件
Wavefront OBJ（附 MTL 材质库） · .obj, .mtl · MIME 类型 model/obj
下载 OBJ 示例文件，用来测试 OBJ 导入器、查看器，或需要同时处理模型及其配套文件的上传流程。带贴图的示例是经典的三件套——sample-model-textured.obj、对应的 .mtl 材质库和一张 PNG UV 网格贴图——既提供散装文件（放在同一目录下，从 URL 加载时相对路径可以正常解析），也提供 ZIP 打包版。
其余文件各自针对解析器容易出错的一种情况：有法线和 UV 但没有材质库的 OBJ、只有顶点位置的 51,200 个三角形文件，以及未三角化、由四边形、五边形和六边形组成的文件。顶点位置、纹理坐标和法线使用各自独立的索引（f v/vt/vn），与真实导出器的写法一致，而不是每个顶点共用一个索引。
下载 OBJ 示例文件
| 文件 | 详情 | 大小 | 下载 |
|---|---|---|---|
sample-model-textured.mtl | 1 种材质 | 198 B | |
sample-quads-and-ngons.obj | 128 个多边形 · 158 个顶点 · 米，Y 轴朝上 | 5 KB | |
sample-uv-grid-texture.png | 512 × 512 | 37 KB | |
sample-model-textured-obj-mtl-png.zip | 3 个条目 · 4,096 个三角形 · 2,048 个顶点 · 法线 · UV · 1 种材质 · 米，Y 轴朝上 | 120 KB | |
sample-model-no-mtl.obj | 4,096 个三角形 · 2,048 个顶点 · 法线 · UV · 米，Y 轴朝上 | 336 KB | |
sample-model-textured.obj | 4,096 个三角形 · 2,048 个顶点 · 法线 · UV · 1 种材质 · 米，Y 轴朝上 | 336 KB | |
sample-model-positions-only.obj | 51,200 个三角形 · 25,600 个顶点 · 米，Y 轴朝上 | 1.7 MB |
在命令行或 CI 中使用这些文件
每个 URL 都稳定不变并开放 CORS。在测试中固定 SHA-256，一旦测试夹具发生变化，你会立刻知道。
# 下载单个文件 curl -O https://pnb-freetoolsforweb.s3.us-east-2.amazonaws.com/samples/3d/obj/sample-model-textured.mtl # 校验文件（上方每个文件都列出了 SHA-256） shasum -a 256 sample-model-textured.mtl # 所有示例文件的机器可读索引 curl https://pnb-freetoolsforweb.s3.us-east-2.amazonaws.com/samples/index.json | jq '.files[] | select(.format=="obj")'
OBJ 格式概览
| 全称 | Wavefront OBJ（附 MTL 材质库） |
|---|---|
| 扩展名 | .obj, .mtl |
| MIME 类型 | model/obj |
| 编码 | 纯文本（UTF-8），每行一个元素 |
| 面 | 三角形、四边形和 n 边形；索引从 1 开始，允许负索引 |
| 材质 | 外部 .mtl 文件（mtllib / usemtl）；贴图通过 map_Kd 指定 |
| 单位 | 文件中不记录——这些示例以米为单位，Y 轴朝上 |
| 三角形数量 | 308（等效）至 51,200 |
用 OBJ 示例文件测试什么
- 用相对路径加载 OBJ + MTL + 贴图
- 以 ZIP 形式接收模型及其配套文件
- 处理缺失或可选的材质库
- 导入时将四边面和多边面三角化
- 独立的 v / vt / vn 索引
- 在 1.7 MB 文件上测试文本解析性能
常见问题
MTL 文件是什么？一定需要吗？
MTL（材质模板库）保存 OBJ 的颜色和贴图引用。OBJ 用 mtllib 行指定它，用 usemtl 分配材质。没有它几何体仍能加载，只是没有贴图——无 MTL 示例正好可以用来测试这一点。
为什么贴图在我的查看器里是上下颠倒的？
OBJ 的纹理坐标以图片左下角为 (0, 0)。有些引擎以及所有 glTF 数据则以左上角为原点。我们的 UV 网格在左下角标有 A1，并带有 U 和 V 箭头，一眼就能看出你的加载器是否翻转了 V。
OBJ 支持动画或顶点颜色吗？
不支持动画。顶点颜色只是一种非官方扩展（每行 v 后面附加的数字），很多读取器会忽略，所以我们没有使用。需要颜色请用 PLY；需要动画请用 glTF 或 FBX。
这些文件使用什么单位和朝上轴？
glTF、GLB、OBJ、PLY、OFF、DAE 和 USDZ 为 Y 轴朝上、单位为米（环面结直径约 1.4 m）。STL 和 3MF 为 Z 轴朝上、单位为毫米，并按切片软件的习惯放置在 z = 0 上。FBX 为 Y 轴朝上、单位为厘米。每个文件的单位和朝上轴都列在其详情中，方便你检查导入器的缩放和旋转是否正确。
这些模型是从哪里来的？
由我们自己生成。脚本先用公式构建几何体（环面结、UV 球、立方体，以及用布尔建模库制作的支架），再按各格式规范逐字节写出文件。没有任何模型是下载、扫描或从他人模型转换而来的，因此可免费用于任何用途（包括商业用途），无需署名。
下载这些 OBJ 文件安全吗？
安全。每个文件都由我们自己的开源脚本从零生成——没有抓取或用户上传的内容——不包含脚本、宏或可执行文件。本页公布了每个文件的 SHA-256，方便你校验收到的文件。
可以将这些 OBJ 示例文件用于商业用途吗？
可以。它们可免费用于任何用途，包括商业产品、测试套件、演示和再分发，无需署名。不需要任何授权，也不必征求任何人的同意。
可以直接外链这些文件或在 CI 中使用吗？
可以。每个链接都是稳定的 HTTPS 直链，带有 Access-Control-Allow-Origin: * 和较长的缓存头，curl、wget、fetch() 和测试运行器都可以直接拉取。每个页面都链接了所有文件的 JSON 索引（见命令行部分）。
相关示例文件
支持 OBJ 的免费工具
发现问题，或者觉得哪里可以更好？每条消息我们都会阅读，并尽快修复。