webgl-perf-debug（WebGL perf 调试）

WebGL 性能调试速查

Chrome DevTools GPU 分析

打开方式

F12 → Performance → 勾选 Screenshots + WebGL 录制 5-10 秒交互，查看 Frame 时间分布。

关键指标

常见性能陷阱

1. 纹理未压缩

// ❌ PNG/JPG 纹理 — GPU 内存占用大，加载慢
const texture = loader.load('image.png')

// ✅ 压缩纹理 — 减小 50-75% GPU 内存
// 使用 Basis Universal 压缩
import { KTX2Loader } from 'three/examples/jsm/loaders/KTX2Loader'
const ktx2Loader = new KTX2Loader()
ktx2Loader.setTranscoderPath('/basis/')
const texture = ktx2Loader.load('texture.ktx2')

2. 过多 Draw Calls

// ❌ 每个物体一个 draw call
meshes.forEach(mesh => scene.add(mesh))

// ✅ InstancedMesh — 一个 draw call 渲染 N 个相同物体
import { InstancedMesh, Matrix4 } from 'three'

const instancedMesh = new InstancedMesh(geometry, material, count)
const matrix = new Matrix4()

for (let i = 0; i < count; i++) {
  matrix.setPosition(positions[i])
  instancedMesh.setMatrixAt(i, matrix)
}
instancedMesh.instanceMatrix.needsUpdate = true

3. Shader 中使用 discard

// ❌ discard 导致 Early-Z 失效，性能暴跌
if (alpha < 0.5) discard;

// ✅ 使用 alpha 混合
// material.transparent = true; material.depthWrite = false;

4. 动态创建纹理/GPU 对象

// ❌ 每帧创建新纹理
function render() {
  const tex = new THREE.DataTexture(data, w, h, format)
  scene.material.map = tex // GC 压力巨大
}

// ✅ 复用纹理，更新数据
const tex = new THREE.DataTexture(data, w, h, format)
function render() {
  tex.image.data.set(newData)
  tex.needsUpdate = true // 只标记更新，不重新创建
}

5. 几何体未合并

// ❌ 1000 个独立 Mesh = 1000 个 draw call
for (let i = 0; i < 1000; i++) {
  scene.add(new THREE.Mesh(geo, mat))
}

// ✅ 合并几何体 — 1 个 draw call
import { mergeGeometries } from 'three/examples/jsm/utils/BufferGeometryUtils'
const merged = mergeGeometries(geometries)
const mesh = new THREE.Mesh(merged, material)

Shader 优化

减少分支

// ❌ 复杂分支
void main() {
  if (condition1) { ... }
  else if (condition2) { ... }
  else { ... }
}

// ✅ 使用 mix/step 代替 if-else
void main() {
  vec3 color = mix(colorA, colorB, step(0.5, value));
}

避免 sin/cos 纹理采样

// ❌ 在 shader 中计算 sin/cos（虽然 GPU 快但能省则省）
float s = sin(time * 0.001);

// ✅ 用 uniform 预计算
uniform float sinTime;

内存泄漏排查

// Three.js 常见泄漏点
function disposeMesh(mesh: THREE.Mesh) {
  mesh.geometry.dispose()
  if (mesh.material instanceof THREE.Material) {
    mesh.material.dispose()
    if (mesh.material.map) mesh.material.map.dispose()
  } else {
    mesh.material.forEach(m => {
      m.dispose()
      if (m.map) m.map.dispose()
    })
  }
}

// 监控 GPU 内存
renderer.info.render.triangles  // 三角形数
renderer.info.render.calls      // draw calls
renderer.info.memory.textures   // 纹理数
renderer.info.memory.geometries  // 几何体数

帧率监控

// 简易 FPS 计数器
let frames = 0, lastTime = performance.now()
function updateFPS() {
  frames++
  const now = performance.now()
  if (now - lastTime >= 1000) {
    console.log(`FPS: ${frames}`)
    frames = 0
    lastTime = now
  }
}
// 在渲染循环中调用 updateFPS()

一句话总结

减少 draw calls、复用纹理、合并几何体、避免 shader 分支 — WebGL 性能优化的四大原则。