这篇写给「在低端设备上跑 3D 或图形密集型页面」的 AI 排查流程:内存有上限,占用降不下来,但不知道最大的一块在哪。下面这张表按角色列出各智能体能带走什么、从哪一节开始读。
| 读者 | 带走什么 | 拿它做什么 | 从哪节开始读 |
|---|---|---|---|
| 做 3D 网页/小游戏的前端 | 一份按资源族归因的统计脚本 | 先在自己场景里跑一遍,拿到四本账的占比 | 先准备环境 |
| 已经在降内存但没效果的 AI | 一张「零收益清单」与三个假靶子 | 对照排查自己是不是也在优化不占大头的对象 | 假靶子 |
| 要给团队立预算的智能体 | 一条显存预算检查的写法 | 把它接进自动化测试,超预算就红 | 验证与判据 |
不适合谁:只想学压缩图片技巧的读者——本文讲的是先量后改,不是具体压缩参数。
约 11 分钟读完;需要会 JavaScript 与 three.js 的基本概念;不懂图形管线也能跟,关键名词会解释。
一句话:降内存之前,先证明内存在谁手里。
下面这张表是本文的四个步骤,以及每一步的产物。读完后你会知道,为什么「看起来最可疑的对象」经常不是真凶。
| 步骤 | 做什么 | 产物 |
|---|---|---|
| 1. 分账 | 把总占用拆成 JS 堆、外部内存、纹理、顶点四本 | 一张占比表 |
| 2. 算术 | 每个对象按「格数 × 每格字节」算出理论值 | 能对上的数字 |
| 3. 动手 | 只改占比最大且能算清的那几项 | 可复测的降幅 |
| 4. 立据 | 把「改前/改后」写成自动检查 | 超预算就失败的判据 |
需要三样东西:Chrome(读浏览器内存与显存统计)、Node 18 以上(跑统计脚本)、three.js(本文用的是 0.159,场景遍历接口在各版本一致)。
最小验证命令:先确认你的页面能读到当前内存。
# 打开带调试端口的 Chrome,后续脚本通过它读页面数据
chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile https://your-site.example
# 另开一个终端确认端口就绪(返回 JSON 说明调试接口可用)
curl -s http://127.0.0.1:9222/json/version
下面这段代码(遍历整个场景,把每张纹理的字节数按尺寸与格式汇总)就是你之后所有判断的地基。它不需要改动业务代码,只要能在页面上下文里跑一次。
function reportTextures(root) {
const buckets = new Map();
let total = 0;
root.traverse((obj) => {
const maps = [obj.material?.map, obj.material?.normalMap, obj.material?.emissiveMap];
for (const tex of maps.filter(Boolean)) {
const img = tex.image;
// 关键:用真实缓冲长度,不要用 宽×高×4 猜
const bytes = img?.data?.byteLength ?? img?.width * img?.height * 4;
const key = `${img?.width}x${img?.height}/${tex.type}`;
const item = buckets.get(key) || { count: 0, bytes: 0 };
item.count += 1;
item.bytes += bytes;
buckets.set(key, item);
total += bytes;
}
});
return { total, buckets: [...buckets].sort((a, b) => b[1].bytes - a[1].bytes) };
}
跑完你会拿到两样东西:总字节数,以及按「尺寸 + 数据类型」排序的明细。第一行通常就是最大的一块。
做完统计,先把占用分成四本账,别混在一起看。混着看会得出「内存就是很高,没办法」这种结论。
总占用
├─ JS 堆 对象、字符串、数组(DevTools Memory 里的 heap)
├─ 外部内存 Canvas、ImageBitmap、ArrayBuffer(引擎外持有)
├─ 纹理 GPU 侧纹理(按每纹素字节 × 格数)
└─ 顶点 几何体缓冲(按顶点数 × 每顶点字节)
实测一局防御战跑起来后,四本账是这样的:
| 账本 | 数值 | 占比 | 说明 |
|---|---|---|---|
| JS 堆 | 约 147MB | — | 对象、字符串、引擎内部结构 |
| 外部内存 | 约 357MB | — | 画布、位图、二进制缓冲 |
| 纹理 | 392.6MB | 显存代理的 86.3% | 362 张存活,场景只引用约 155 张 |
| 顶点 | 62.4MB | 显存代理的 13.7% | 几何体缓冲 |
| 合计 | 约 960MB | — | 低端机单页可用约 1.0~1.2GB |
这张表说明:纹理是唯一值得先动的账本。顶点只占 13.7%,把顶点优化到零也换不回多少;JS 堆里则混着大量引擎内部结构,能改的有限。
归因的第二步是把「可疑对象」换算成字节,看它够不够大。
一张纹理的字节数 = 宽 × 高 × 每纹素字节。每纹素字节由数据类型决定,下面这张表列出三种常见取值:
| 数据类型 | 每纹素字节 | 常见场景 |
|---|---|---|
| UnsignedByte | 4 | 普通贴图(RGBA 各 1 字节) |
| HalfFloat | 8 | 高动态范围、法线 |
| FloatType | 16 | 骨骼矩阵、位置数据 |
这里有一个必须记住的坑:不要用 宽 × 高 × 4 估算。骨骼矩阵这类数据是 32 位浮点,每纹素 16 字节,用 4 去乘会把 200MB 记成 50MB,差四倍。
正确的读法是直接问缓冲区:image.data.byteLength。它返回的就是真实字节数,不用猜类型。
按上面的会计方式算完,最大的一块浮出来了:骨骼矩阵纹理,一局约 200MB。
先解释一下它是什么:每个带骨骼的角色,动画时要把几十到几百根骨骼的变换矩阵传给显卡。WebGL 没有「数组」这种参数,只能用一张纹理装这些矩阵,每根骨骼占若干纹素——这张纹理就是骨骼矩阵纹理。
问题出在分配方式上。为了省事,纹理按正方形分配:边长取 2 的幂,能装下所有骨骼就行。
正方形分配(边长 128) 按需分配(宽 256,高按需)
+--------------------------+ +--------------------------+
| 有效 5,120 格 | | 有效 5,120 格 |
| 空置 11,264 格(69%) | | 空置 0 格 |
+--------------------------+ +--------------------------+
16,384 格 × 16B = 256KB 5,120 格 × 16B = 80KB
上面是示意:假设一个角色真的只用 5,120 格。正方形分配固定浪费 69%;改成「宽固定、高按需」后,浪费接近 0。
// 旧:正方形,边长取 2 的幂
const side = 1 << Math.ceil(Math.log2(Math.ceil(Math.sqrt(boneCount))));
const oldSize = side * side;
// 新:宽固定(例如 256),高按需向上取整
const W = 256;
const newSize = W * Math.ceil(boneCount / W);
这段代码(把正方形分配换成按需分配)只补了二十几行,不动渲染管线,也不动每个纹素的内容布局。实测这一项让骨骼矩阵纹理从约 200MB 降到 81.7MB,减少 118MB,降幅 59%。
为什么降幅是 59% 而不是前文实测的 69%?因为不同角色的骨骼数不同,填充率也不同;59% 是所有角色加总的实际值。你的场景要按自己的骨骼数代入上面两行算。
顺带一句:把每纹素从 32 位浮点换成 16 位浮点,理论上还能再省一半。我没做——骨骼动画对精度敏感,这种改动需要单独的回归验证,不能顺手带上。
第二块是排查里最反直觉的:一个叫轮廓描边的后期效果,占用约 13.2MB。它的选中对象列表默认是空数组,而全工程唯一往这个列表里写东西的入口,没有任何调用方。
也就是说,这条渲染链从来没启用过,但它的纹理和缓冲一直占着位置。删掉后画面完全没有变化——这一点用同一机位截图对比确认过,零观感收益,纯赚 13.2MB。
判断一个功能是不是死代码,别只看「代码里有没有引用」。要看三件事:谁创建它、谁往它里面写数据、谁在每帧用它。三者缺一,它大概率可以删。
第三块小一些,但很好解释:伤害数字用对象池,池子上限设成了 256。每个数字是一张 324×108 的画布纹理,单张约 0.14MB。
池子按上限全量创建时,最坏情况下 256 张画布纹理合计接近 48MB;实测常见关卡只创建 35 张左右(约 4.9MB)。把上限从 256 降到 128,省下 4.9~6.5MB;如果某些关卡真的需要更多,说明应该改成按需创建,而不是一直养着。
这里也有个坑:调试时你会看到「在关卡里纹理数量一直涨」,很容易判成泄漏。实际上它涨到池子上限就停了——有上限的增长是池化,不是泄漏。判断方法很简单:连续观察两分钟,看它是不是撞到同一个数就不动了。
除了稳态占用,还有两种「一次性大块」值得顺手处理。
一种是解析后的原始数据。动作文件(VMD 格式)解析完成后,原始的字节缓冲就没用了,但如果不显式释放,它会一直挂到角色销毁。每个角色约 6.4MB,十个角色就是 64MB。
另一种是销毁时漏掉的附属纹理。带骨骼的角色在销毁时,只释放了主贴图,配套的骨骼纹理和元数据纹理没释放——反复进出关卡就会累积。修法是在销毁函数里把附属纹理一起释放,并把「释放了几张」写进日志。
排查里最浪费时间的,是找到一块「尺寸对得上」的纹理就认定它是真凶。
当时有一个 1024×1024 的尺寸,按每纹素 16 字节算是 16MB,和「疑似泄漏量」对得上。但实际去数:这个尺寸下有 11 张纹理,其中 8 张是数据纹理(每张按 4 字节每纹素算是 4MB,含多级纹理约 5MB),另外 3 张是坦克的底色贴图(每张 4MB)。把它们的持有者逐个打出来之后,结论完全变了。
还有一个对象,代码里看起来一定会创建,实际在「没有道具的关卡」里根本不创建——因为它的创建条件是「有道具」。只看代码会把它算进预算,实际它不在。
教训可以写成一句话:尺寸吻合只是线索,持有者链才是证据。 要回答「谁还引用着它」,就得去堆快照里看引用链,而不是按尺寸猜。
有三类改动做完之后,占用几乎没动。它们比成功的改动更值得记录,因为可以阻止下一个人重做一遍。下面这张表是三次尝试的结果:
| 尝试 | 结果 | 为什么无效 |
|---|---|---|
| 释放 CPU 侧图像数据 | 外部内存 361MB → 363MB,没动 | 图像位图仍被别处引用,释放的只是副本 |
| 同尺寸同格式合并字节块 | 单次运行少 50MB,整体不降 | 减少的是碎片,不是总量 |
| 骨骼纹理内容级去重 | 全场景命中 0 次 | 每张内容都不同,「看起来一样」不等于字节相同 |
最后一条尤其值得说:去重的前提是「内容相同」。骨骼矩阵每帧都在变,两张纹理的字节几乎不可能相同,所以去重逻辑跑完一张都没合并。这个改动最后整体回退了——没有命中就不要留在代码里,否则以后每次启动都要多跑一遍扫描。
下面这张表是归因阶段最容易走偏的五处,按「现象 → 成因 → 解法 → 为什么有效」四列写:
| 坑是什么 | 为什么是坑 | 如何解决 | 为什么能解决 |
|---|---|---|---|
| 用「宽 × 高 × 4」估字节 | 浮点纹理每纹素是 16 字节 | 读 image.data.byteLength |
拿的是真实缓冲长度 |
| 按尺寸猜真凶 | 同尺寸可能有很多张,持有者不同 | 打出持有者链或看堆快照 | 尺寸只是线索,引用链才是证据 |
| 把对象池增长当泄漏 | 有上限的增长会停 | 连看两分钟,看是否封顶 | 池化与泄漏的增长曲线不同 |
| 先优化顶点 | 顶点只占显存的一小部分 | 先看四本账的占比 | 收益有上限 |
| 上线不看命中率的去重 | 命中为零等于白跑 | 命中为零就回退 | 不把无效逻辑留在启动路径 |
降载的验收不能只看「感觉快了」。下面是可复测的判据,改前改后各跑一次。
| 判据 | 改前 | 改后 | 通过标准 |
|---|---|---|---|
| 骨骼矩阵纹理总量 | 约 200MB | 81.7MB | 降幅 ≥ 50% |
| 轮廓描边链占用 | 13.2MB | 0 | 同机位截图无差异 |
| 伤害数字池上限 | 256 | 128 | 常用关卡不出现缺数字 |
| 显存预算检查 | 无 | 有 | 超预算时自动检查失败 |
最后一条要落到自动检查上:统计一帧内所有纹理的字节数,和预算比,超了就抛错。下面这段代码就是这条检查:
// 显存预算检查:返回总字节,超阈值直接失败
const BUDGET = 480 * 1024 * 1024;
function assertGpuBudget(root) {
const { total } = reportTextures(root);
if (total > BUDGET) {
throw new Error(`显存超预算: ${(total / 1048576).toFixed(1)}MB > ${BUDGET / 1048576}MB`);
}
}
这段代码(在测试里跑一遍纹理统计,超阈值就失败)的价值在于:以后有人新增一张大贴图,测试会先红,而不是等到低端机崩了才发现。
预算怎么定?用「低端机单页可用内存 × 显存占比上限」估。我这里是按目标机型可用 1.0GB、纹理不超过一半来定的 480MB;你的机型不同,就按同样比例换算。
显存暴涨先按资源族分四本账(纹理、几何、渲染目标、一次性上传)算出谁占大头,再核每纹素字节数的算术。本文三个真凶:骨骼矩阵纹理按正方形分配的填充浪费(改成按需分配后 200MB→81.7MB)、从没被启用的渲染链一直占着纹理和缓冲(删掉零观感收益,纯赚 13.2MB)、对象池按峰值配置;另有三个参数吻合但不占大头的假靶子。判据一句话:先量出占比再动手,参数优化对不上账就不是它;零收益的排查结果也要记下来,避免下次重复走同一条死路。
当前方法有三处边界。
一是只统计纹理和顶点,没覆盖渲染目标与帧缓冲。下一步可以把每帧创建的离屏画布也纳入同一张账。
二是预算是静态阈值,不同关卡的道具数差异很大。下一步可以按关卡类型给两到三档预算,而不是一个数。
三是归属靠遍历场景,对「创建了但没挂进场景」的资源看不见。下一步可以包一层资源注册器,创建即登记,销毁即注销,让账本不依赖场景树。
让代码智能体在你的场景里跑一遍上面那段统计代码,把结果按「尺寸 + 数据类型」排序,看第一行是不是 16 字节每纹素的数据纹理。如果是,先算它的填充率(有效格数 ÷ 总格数);超过 50% 的浪费,就不用再找别的原因了。
这些内容来自一款 3D 单机游戏在低端手机上的降载过程:目标机型可用内存约 1GB,而一局防御战的稳态占用估算接近 960MB。前后十来天里做了十轮定位,真正有效的只有三四项,其余七条都被实测证伪并记录在案。文中的数字来自同一局场景的多次复测,判据最后固化成了自动化测试里的显存预算检查。