OBJ文件是什么?一文看懂Wavefront OBJ格式

OBJ文件是什么?它是一种用纯文本写成的3D模型:先一行行列出顶点坐标、贴图坐标(UV)和法线,再用面把它们按编号连起来。这个格式由Wavefront Technologies为自家的Advanced Visualizer软件设计,如今几乎所有3D软件都能打开。颜色和贴图并不写在.obj里,而是放在配套的.mtl材质文件和图片中,所以一个OBJ模型常常是一个文件夹或一个压缩包。

更新于 2026-11-17

用记事本打开一个.obj文件,你能直接读懂这个模型。OBJ格式的大部分特点都源于此:一行文字能写下的信息,它就能存;写不下的,要么放进另一个文件,要么干脆没有。

OBJ格式的来历

OBJ出自Wavefront Technologies,一家1984年在美国圣巴巴拉成立的图形软件公司(见维基百科),最初是为自家的Advanced Visualizer动画软件设计的。按照美国国会图书馆的格式说明,OBJ大约从1990年开始使用,规范刊登在Advanced Visualizer手册的附录B1里。今天大家参照的仍是这份文本,Paul Bourke的网站上有OBJ规范和MTL材质格式的镜像。

规范里提到过一种扩展名为.mod的二进制版本,但从未公开文档,所以实际流通的OBJ文件都是文本。1995年Silicon Graphics把Wavefront和Alias合并,2006年Autodesk又收购了Alias;文本格式的OBJ则一直作为不绑定厂商的交换格式流传下来。2020年2月,媒体类型model/obj在IANA完成注册。

OBJ格式逐行拆解

每一行以一个关键字开头,#开头的是注释。下面是一个完整、合法的OBJ文件,内容是一块朝向+Z方向、带贴图的正方形:

# tile.obj:一块带贴图的正方形
mtllib tile.mtl
o tile
v 0 0 0
v 1 0 0
v 1 1 0
v 0 1 0
vt 0 0
vt 1 0
vt 1 1
vt 0 1
vn 0 0 1
usemtl tiles
f 1/1/1 2/2/1 3/3/1 4/4/1
关键字含义示例
v顶点坐标 x y z(可选第四个值w,默认1)v 1 0 0
vt贴图坐标(UV),一般在0到1之间vt 1 0
vn法线方向,用于平滑着色vn 0 0 1
f面:每个角写成v/vt/vn三个编号f 1/1/1 2/2/1 3/3/1
o / g开始一个命名物体 / 命名组o tile
s平滑组开关s off
mtllib要加载的材质库文件mtllib tile.mtl
usemtl后面的面使用哪个材质usemtl tiles

编号从1开始,按行出现的顺序计数,不是从0开始。面可以不写UV(f 1//1 2//1 3//1),也可以只写顶点(f 1 2 3)。负数编号表示从最近的顶点往回数,不过维基百科提醒,并非所有软件都支持这种写法。

一个带贴图木箱的OBJ文件全部28行,按关键字着色,旁边是木箱渲染图和mtllib、o、v、vt、vn、usemtl、f的图例
一个真实的491字节OBJ:8个顶点、6个四边面拼成一个带贴图的箱子,4组UV和6条法线按编号在各个面之间共用。

面是按编号引用顶点的,所以六个面共用的一个角只写一次;STL则在每个三角形里把角点重复写一遍。这对文件大小有多大影响,见STL和OBJ区别里的实测。

物体和组

o 名称开始一个命名物体,g 名称开始一个组。有意思的是,规范原文说Wavefront自己的程序并不处理o,但现在的导入器两者都认:Blender就有按物体拆分、按组拆分两个选项,把每一段变成单独的物体。不过OBJ没法嵌套:没有层级、没有父子关系,也没有单个部件的变换。

紫色玩具越野车导入3D软件后,右侧场景列表里有车身vehicle-suv和四个车轮
toy-suv.obj里有5行o,导入后就是5个物体:车身和四个车轮可以分别选中、单独移动。

面可以是三角形、四边形或多边形

规范只要求每个面至少三个角,没有设上限,所以f 1 13 14 2这样的四边面再正常不过。建模师喜欢保留四边面,因为循环边好选、好改;游戏引擎、切片软件和我们的转换工具需要三角形,导入时会把多边形拆开。

两个线框圆环并排:左边由四边面组成,右边由三角面组成
同一个圆环:288个四边面(17 KB)对比576个三角面(22 KB)。两个文件的288个顶点完全相同,只有f行不一样。

规范里还定义了自由曲线和曲面,但美国国会图书馆指出并不是所有3D软件都能处理。你下载到的OBJ,几乎都是多边形网格。

MTL文件:颜色和贴图放在哪里

mtllib指定的是材质库,这是另一种文本格式,美国国会图书馆也给它单独建了条目。里面newmtl开始一个材质,Kd是漫反射颜色(红、绿、蓝,取值0到1),map_Kd指向用作颜色贴图的图片。上面那块正方形配套的tile.mtl只有三行:

newmtl tiles
Kd 1.0 1.0 1.0
map_Kd tiles.jpg

所以一个带贴图的OBJ模型其实是三类文件:.obj、.mtl和图片。

木箱模型的文件关系图:OBJ指向MTL,MTL再指向颜色贴图和法线贴图,右侧是完整的木箱渲染
一个带贴图的OBJ,一共四个文件:wooden-crate.obj(457 KB)引用220字节的.mtl,.mtl再指向83 KB的颜色贴图和62 KB的法线贴图。

颜色之外的贴图通道,各家支持不一。MTL原始规范里有bump和disp;木箱里那行norm来自2015年一份给MTL加PBR材质的提案,美国国会图书馆提到three.js只认其中一部分关键字。所以同一张法线贴图,换个软件可能就不生效了。

扫描模型通常更简单:一个OBJ、一个.mtl、一张颜色贴图。

3D扫描的青花瓷瓶,旁边列出OBJ、MTL和贴图的文件大小,以及一张网格线框特写
史密森尼开放资源(CC0)里的扫描模型,为网页做过减面:4.4 MB的OBJ含52,499个三角面,一个129字节的.mtl,一张1024 × 1024贴图。

.mtl里的文件名通常是相对路径:当年的Advanced Visualizer要求.mtl和.obj放在同一目录,现在的软件也大多在.mtl旁边找图片。少了任何一个文件,模型照样能打开,只是“妆”没了。

石榴模型:左边红色带贴图,右边是纯灰色
左:pomegranate.obj加上137字节的.mtl和37 KB贴图。右:同一个OBJ少了.mtl,只加载出几何形状,查看器只能显示成灰色。

要把OBJ发给别人?整个文件夹一起压缩

把.obj、.mtl和所有图片放进同一个文件夹再打包成zip。发之前用记事本看一眼.mtl:如果map_Kd后面是C:/Users/...这样的绝对路径,改成只写文件名。

顶点色:常见但非官方的扩展

美国国会图书馆明确说,OBJ原始规范不支持逐顶点颜色。业内流行的做法是在坐标后面再加三个数:v x y z r g b,每个取值0到1。这样不需要.mtl,一个文件就能带颜色,但存不了图片贴图。

支不支持要看软件和版本。MeshLab的读取代码会解析它(见vcglib源码),three.js的OBJ加载器也会;Blender从2022年的3.3版开始能导入这种顶点色,同时支持ZBrush的#MRGB写法(见3.3版更新说明)。更早的Blender和不少其他软件会忽略后面三个数,模型显示成灰色。

低多边形海盗船,旁边是OBJ文本,每行v末尾带三个红绿蓝数值
sloop.obj不用.mtl,把颜色存在1,957个顶点上:每行v有六个数,后三个就是红、绿、蓝。

Ship3D的转换工具输出OBJ时也用这种写法,只交给你一个文件:纯色材质会烘焙成顶点色,贴图颜色也会按每个顶点的UV取样烘焙进去,色块贴图能准确还原,细节丰富的贴图只是近似。UV会保留,但图片本身不包含,想要完整的贴图细节,需要把原贴图重新连上。

OBJ格式不保存哪些信息

  • 单位。 坐标只是数字。OBJ文件的尺度差别太大,Blender导入器甚至专门有一个“限制包围盒”选项。
  • 动画和骨骼。 美国国会图书馆写明OBJ没有动画序列和骨架,Blender手册也列出不支持骨架、灯光、相机和父子关系。
  • 现代材质。 PBR参数只能靠非官方的MTL扩展。

OBJ文件怎么打开、转换和压缩

桌面软件。 Blender里选“文件 → 导入 → Wavefront (.obj)”,同目录下有对应的.mtl时会一起导入材质。MeshLab和大多数切片软件也能导入OBJ。

浏览器在线看。 我们的在线OBJ查看器用three.js在你本机打开单个.obj文件:旋转、缩放、查看文件大小和三角面数,还能另存为GLB、STL、OBJ或FBX。它能显示顶点色,但不会读取单独的.mtl和图片,带贴图的模型在这里会显示成灰色。

Ship3D OBJ查看器里打开的低多边形帆船,下方显示文件名、大小、三角面数和四个另存为按钮
在Ship3D OBJ查看器里打开sailing-ship.obj(230.9 KB,1,849个三角面,顶点色),下方可另存为GLB、STL、OBJ和FBX。

在浏览器里打开OBJ文件

免费,无需注册,文件不上传。支持最大200 MB:旋转、缩放、查看三角面数,并可另存为GLB、STL、OBJ或FBX。

打开OBJ查看器

格式转换。 要打印,用OBJ转STL,几何保留,材质和UV丢弃;要进游戏引擎,用OBJ转FBX导出二进制FBX;要放到网页上,用OBJ转GLB得到单个文件;手上是COLLADA模型,用DAE转OBJ。

压缩体积。 扫描模型和AI生成的模型动辄几百万个面。OBJ文件压缩工具在浏览器里减少三角面数,输出的OBJ只保留顶点和面,不含UV、法线和材质,适合没有贴图的网格或准备拿去打印的模型。

OBJ和STL、GLB、FBX怎么选

OBJSTLGLBFBX
编码文本二进制或文本二进制glTF 2.0二进制或文本(Autodesk)
面三角形、四边形、多边形只有三角形三角形三角形、四边形、多边形
颜色和贴图单独的.mtl + 图片标准里没有打包在文件内(PBR)内嵌或外链
动画和骨骼无无有有

只要几何和UV、希望哪个软件都能读,选OBJ;网页上要一个带贴图的单文件,选GLB;带骨骼动画的游戏资产选FBX;送进切片软件就用STL(详见STL文件是什么)。

小结

OBJ文件是什么?一份人能读懂的顶点、UV、法线和面的清单,从1990年前后起就在各种3D软件之间流转。它支持四边面和命名部件,颜色和贴图放在单独的.mtl和图片里,不存单位,也不存动画。只要几个文件放在一起,OBJ几乎在哪儿都能打开。

常见问题

OBJ文件一般用来做什么?

主要用来在不同软件之间传递3D模型。建模和雕刻软件、渲染器、游戏美术流程、3D扫描仪和切片软件都认OBJ,所以它是很常见的下载和导出格式。它是带公开规范的纯文本,也适合存档和手动修改。

OBJ文件怎么打开?

用Blender(文件 → 导入 → Wavefront (.obj))或MeshLab导入即可;不想装软件,就拖进我们的免费在线OBJ查看器,模型在本机浏览器里显示,不会上传。用桌面软件打开时,请把.mtl和贴图图片放在.obj同一个文件夹里,软件才找得到。

OBJ旁边的.mtl文件是什么?

它是材质库文件。OBJ通过mtllib这一行指定它,.mtl里定义每个材质:Kd之类的颜色,以及map_Kd指向的贴图图片。少了它模型照样能打开,但只剩没有贴图的几何形状。

为什么OBJ模型打开后是灰色或白色的?

多半是.mtl或贴图缺失、改了名,或者.mtl里写的路径在你电脑上不存在。把所有文件放进同一个文件夹,再核对.mtl里的文件名。如果颜色是用顶点色存的,也可能是这个软件不支持这种非官方扩展。

OBJ文件有单位吗?

没有。OBJ里的坐标只是数字,不带单位,1到底是1毫米还是1米由打开它的软件决定。扫描模型常用米,CAD导出常用毫米,导入后先看看尺寸,不对就缩放。

OBJ文件能保存动画吗?

不能。OBJ格式没有关键帧、骨骼、蒙皮和变形目标,也没有物体层级。需要动画或绑定时,请用FBX或glTF / GLB。

相关内容