VS Code需装扩展才能预览3D模型，核心依赖WebView轻量渲染器；最稳定格式为.glb/.gltf，.obj易缺材质，.stl仅含几何体；右键“Preview 3D Model”是标准入口，路径错误或格式不匹配是打不开主因。
直接装插件就能预览，但格式和路径必须对
VS Code 本身不渲染 3D 模型，所有预览都靠扩展在 WebView 里跑轻量级渲染器。装完插件后打不开模型，90% 是因为文件格式不匹配或路径写错。
支持最稳的是 .glb 和 .gltf；.obj 虽然能预览，但常缺材质/纹理（.mtl 文件没同目录或路径不对）；.stl 只有几何体，无颜色、UV、动画，适合看结构，别指望渲染效果。
- 右键文件 → “Preview 3D Model” 是标准入口，不是双击打开
- 如果右键没这个选项，说明插件没关联该后缀：进设置搜
files.associations，手动加一行"*.obj": "plaintext"再删掉，触发重载（有些插件靠此刷新识别） - GLB 文件必须是单文件封装（含几何+材质+纹理），不要用导出时勾了 “Separate textures” 的 GLTF
推荐插件：glTF Tools > 3D Preview
glTF Tools（由 Microsoft 维护）比 3D Preview 更可靠，尤其对动画、PBR 材质、相机/灯光节点的支持更完整，还带模型结构树和 JSON 面板，方便查 bufferView 偏移或 accessor 类型错误。
安装后无需额外配置，但要注意：
- 它默认只在
.gltf/.glb文件上激活右键菜单；想让它也管.obj，得去插件设置里开glTF Tools: Enable OBJ Support - 预览窗口里按
H键可重置视角，Shift+拖拽是平移（不是Ctrl+拖拽，这点容易记混） - 如果模型黑屏或只显示线框，先检查控制台（
Ctrl+Shift+U打开 Output 面板，选glTF Tools）——常见报错是UNDEFINED_VERTEX_ATTRIBUTE，说明导出时没勾“Export normals”
预览失败时，先验证模型本身是否合法
别急着换插件。很多“打不开”其实是模型损坏或导出设置错误，VS Code 插件只是第一个暴露问题的环节。
- 用官方验证工具：把文件拖到 https://www.php.cn/link/eae5f13231cdefd8f5af75ceceee1401，看有没有
ERROR级提示 - Blender 用户：导出 GLB 时务必关掉
Apply Modifiers（除非你真需要），否则细分修改器可能生成超大顶点数，卡死预览 - OBJ 用户：确保
.obj和.mtl在同一目录，且.mtl里的map_Kd路径是相对路径（如texture.jpg），不是绝对路径或上级路径（../tex/xxx.jpg不支持） - 命令行快速检测：
npx @gltf-transform/cli validate model.glb（需先npm install -g @gltf-transform/cli）
调试模型加载逻辑时，别依赖预览窗口的报错
插件预览是封闭环境，错误信息极简。真要定位材质加载失败、法线翻转、坐标系不一致等问题，得切到真实运行上下文。
比如你在写 Three.js 加载逻辑：
- 别只信预览窗里模型“看起来正常”，用
console.log(gltf.scene.children)看实际加载了几何体、是否有SkinnedMesh - 预览窗不报
THREE.GLTFLoader: Couldn't load texture xxx.png，但你的代码会——所以开发阶段建议用 Live Server 启服务 + 浏览器 DevTools 查 Network 面板 - 法线方向问题（模型一半黑一半亮）在预览窗难判断，但在 Three.js 里加
mesh.material.side = THREE.DoubleSide一试便知
真正卡住的往往不是 VS Code 配置，而是模型数据本身和目标引擎的约定是否对齐。预览只是第一道筛子，不是最终执行环境。
