屏幕角落挂一个小小的数字,实时显示当前页面的帧率——60 是流畅,掉到 30 以下肉眼就能感觉到卡。调动画参数、对比两个特效的开销、判断是不是某个脚本拖慢了页面,看它最直接。
网上流传最广的那个版本依赖 jQuery,实测在没有 jQuery 的页面上完全不显示。下面先放原版(已去掉原作者的署名注释),附上逐条实测数据,再给一份零依赖的修复版。
原版 · 实际效果
// FPS 帧率显示
$('body').before('<div id="fps" style="z-index:10000;position:fixed;top:3;left:3;font-weight:bold;"></div>');
var showFPS = (function(){
var requestAnimationFrame =
window.requestAnimationFrame ||
window.webkitRequestAnimationFrame ||
window.mozRequestAnimationFrame ||
window.oRequestAnimationFrame ||
window.msRequestAnimationFrame ||
function(callback){ window.setTimeout(callback, 1000/60); };
var e,pe,pid,fps,last,offset,step,appendFps;
fps = 0;
last = Date.now();
step = function(){
offset = Date.now() - last;
fps += 1;
if( offset >= 1000 ){
last += offset;
appendFps(fps);
fps = 0;
}
requestAnimationFrame( step );
};
appendFps = function(fps){
console.log(fps+'FPS');
$('#fps').html(fps+'FPS');
};
step();
})();预览里那个数字始终不出现,不是代码没跑——是预览环境没有加载 jQuery,而原版第一行就用了 $。这正是它的第一个问题。
原版实测出的问题(测试环境:Chromium,视口 900×700):
① 没装 jQuery 就完全不显示
| 检查项 | 实测 |
|---|---|
| 页面未加载 jQuery | 报错 $ is not defined |
| 挂件节点数 | 0 |
整段代码从第一行就用 $,一报错后面全不执行。现在的主题大多不再默认加载 jQuery(WordPress 自带但前端不一定引入),粘上去大概率没反应。
② 挂件被插到了 body 外面
| 检查项 | 实测 |
|---|---|
| 原版写法 | $('body').before(...) |
| 挂件的父节点 | HTML(正确应为 BODY) |
before() 的含义是"插到 body 前面",于是这个 div 成了 <html> 的直接子元素,不在 body 里面。后果是:写在 body 上的字体、颜色、transform、overflow 全都影响不到它,document.body 相关的脚本也找不到它。
③ top:3;left:3 少了单位,等于没写
| 检查项 | 实测 |
|---|---|
| 原版写法 | top:3;left:3 |
| 计算值 | 0px / 0px |
CSS 里长度必须带单位,3 不是合法长度,整条声明被丢弃。所以那个 3px 的留白从来没生效过,数字一直紧贴屏幕边缘。
④ 深色页面上看不见
| 检查项 | 原版(页面背景 #14161c) |
|---|---|
| 文字颜色 | rgb(0, 0, 0) |
| 背景颜色 | rgba(0, 0, 0, 0)(透明) |
原版只设了 font-weight:bold,没有 color 也没有 background——继承默认的黑字透明底。深色主题的页面上,这个数字等于隐形。
⑤ 切到后台再回来,会闪一个假的极低帧率
| 时间 | 原版显示 |
|---|---|
| 切后台前 | 61FPS |
| 刚回到前台 | 31FPS |
| 1.2 秒后 | 61FPS |
切到后台时 requestAnimationFrame 会被浏览器暂停,回来第一帧的时间跨度是好几秒,可期间只累积了 1 帧——算出来就是个位数的帧率。原版没有重置逻辑,要等满一整秒才恢复正常。
⑥ 每秒往控制台打一行
| 观察时长 | 控制台输出 |
|---|---|
| 约 2.4 秒 | 2 行(62FPS、60FPS) |
开着调试面板时刷屏,而且 console.log 本身有开销,测出来的帧率还会偏低一点。
⑦ 占用全局 id="fps"
id 是全局唯一的,fps 又是个很常见的词。一旦主题或其他插件也用了这个 id,$('#fps') 只会取到文档里的第一个,数字就跑到别人的元素上去了。
⑧ 关不掉
没有 remove、没有 hide,也没有开关。调试完想撤掉只能改模板;留在正式站点上,访客会一直看到这个数字。
修复版 · 零依赖 + 三档配色
<style>
.wxz-fps{
position:fixed; left:6px; top:6px; z-index:9999;
padding:3px 8px; border-radius:6px;
font:600 12px/1.4 ui-monospace,Menlo,Consolas,monospace;
color:#fff; background:rgba(28,30,38,.78);
letter-spacing:.02em; cursor:default;
user-select:none; -webkit-tap-highlight-color:transparent;
transition:background-color .25s ease;
}
.wxz-fps.is-good{background:rgba(22,150,70,.88)}
.wxz-fps.is-mid {background:rgba(200,120,10,.90)}
.wxz-fps.is-bad {background:rgba(210,40,40,.90)}
@media (max-width:768px){ .wxz-fps{font-size:11px;padding:2px 7px} }
</style>
<div class="wxz-fps" title="双击关闭">-- FPS</div>
<script>
(function () {
var CFG = { color:true, smooth:true, log:false };
var el = document.querySelector('.wxz-fps');
if (!el) return;
var raf = window.requestAnimationFrame ||
function (cb) { return setTimeout(function(){ cb(performance.now()); }, 16); };
var frames = 0, last = performance.now(), shown = -1, hist = [], running = true;
function paint(v) {
el.textContent = v + ' FPS';
if (CFG.log) console.log(v + 'FPS');
if (!CFG.color) return;
el.classList.remove('is-good', 'is-mid', 'is-bad');
el.classList.add(v >= 55 ? 'is-good' : (v >= 30 ? 'is-mid' : 'is-bad'));
}
function tick(now) {
if (!running) return;
frames++;
var dt = now - last;
if (dt >= 500) {
var v = Math.round(frames * 1000 / dt);
frames = 0; last = now;
if (CFG.smooth) {
hist.push(v);
if (hist.length > 4) hist.shift();
v = Math.round(hist.reduce(function(a,b){return a+b;}, 0) / hist.length);
}
if (v !== shown) { shown = v; paint(v); }
}
raf(tick);
}
/* 切到后台时 rAF 会停,回来若不重置,会先显示一个假的极低帧率 */
document.addEventListener('visibilitychange', function () {
if (document.hidden) return;
frames = 0; last = performance.now(); hist.length = 0;
});
el.addEventListener('dblclick', function () { el.style.display = 'none'; });
window.wxzFps = {
el: el,
hide: function () { el.style.display = 'none'; },
show: function () { el.style.display = ''; },
stop: function () { running = false; el.remove(); }
};
raf(tick);
})();
</script>改动都在细节上,外观从一行黑字变成了带底色的小徽标:
- 去掉 jQuery 依赖:全程原生 JS,
appendChild挂到 body 内,任何站点都能跑。 - 位置带单位:
left:6px;top:6px,实测计算值 6px,留白是真的。 - 加了底色和白字:深色半透明底 + 白色等宽字,浅色深色页面都看得清。
- 三档配色:≥55 绿、30–54 橙、<30 红,扫一眼就知道卡不卡,不用读数字。
- 后台回来先重置:监听
visibilitychange,回到前台立刻重新计数,实测不再出现 31FPS 那种假值。 - 控制台输出默认关闭:
CFG.log改成true才会打印。 - 不用全局 id:靠
.wxz-fps类定位,页面上不留任何 id。 - 更新更快也更稳:从 1 秒一次改成 0.5 秒一次 + 最近 4 次取平均,数字不再乱跳,卡顿也能更快看到。
- 双击关闭,也留了接口:双击挂件即隐藏,
window.wxzFps还能hide()/show()/stop()。
| 检查项 | 原版 | 修复版 |
|---|---|---|
| 无 jQuery 环境 | 报错,节点 0 | 正常显示 |
| 挂件父节点 | HTML | BODY |
top / left |
0px / 0px | 6px / 6px |
| 深色页面可读性 | 黑字透明底 | 白字 + 深色底 |
| 后台回来 | 闪 31FPS | 稳定 58FPS |
| 控制台输出 | 每秒 1 行 | 默认不输出 |
| 全局 id | 占用 fps |
无 |
| 关闭方式 | 无 | 双击 / 接口 |
| 手机上尺寸 | — | 55×19,溢出 0 |
怎么调
- 换个角:改 CSS 里的
left:6px;top:6px。右下角就写right:6px;bottom:6px,同时把left、top删掉——两个都留会以left为准(right被忽略)。 - 改配色阈值:JS 里
v >= 55 ? 'is-good' : (v >= 30 ? 'is-mid' : 'is-bad'),两个数字随便改。高刷屏(120Hz)建议把 55 提到 100。 - 要控制台输出:
CFG.log改成true。 - 不要平滑平均:
CFG.smooth改成false,数字跳动更明显,但瞬时卡顿更敏感。 - 不要配色:
CFG.color改成false,一直是深色底。 - 临时隐藏:双击挂件;彻底移除用
wxzFps.stop(),会连循环一起停掉。 - 怕挡住点击:挂件在左上角可能压住菜单按钮,给
.wxz-fps加一行pointer-events:none即可(代价是双击关闭失效)。
为什么类名带 wxz- 前缀
CSS 是全局生效的,没有作用域概念。只要把 <style> 加进页面,里面的规则就作用于整个站点,而不只是你粘贴的那一块。
像 .fps、#fps 这种名字,撞车概率非常高——主题、统计插件、性能面板都可能用。撞上之后后加载的覆盖先加载的,站上别的地方就莫名其妙变了样。
加上 wxz- 前缀后基本不会撞。所以:
- 照抄时保留
wxz-前缀,别图省事改回短名字。 - 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。
- 这里没有用 id,就是为了不占全局命名空间。
改的时候注意这几点
- 别依赖 jQuery:现在多数主题前端不加载它,用了等于白写。
- 长度一定带单位:
top:3是无效的,必须top:3px。 - 别用
before()挂到 body 外面:appendChild到 body 才是对的。 - 记得设
color和background:只加粗不加底色,深色主题上就看不见。 - 切后台要重置计数:不然回来先闪一个假的低帧率。
- 别用
z-index:10000:会浮在主题弹窗之上,999 就够。 - 正式站点记得关掉:调试完用
wxzFps.stop()或双击隐藏,别让访客看到调试数字。 - 测的是当前页面:帧率跟设备性能、当时开的其他标签页都有关,换个机器数字会不一样。
怎么用
整段粘进页脚 HTML 代码区即可:
- 博客园:后台 → 设置 → 页脚 HTML 代码。
- WordPress:外观 → 小工具 → 页脚区加一个「自定义 HTML」,或者放进子主题的
footer.php。 - Typecho / Hexo / Hugo:对应的页脚模板文件。
CSS、HTML、JS 三段是连在一起的一整块,粘的时候别拆开,也别重复粘贴——重复会出现两个挂件(虽然数字一样,但位置会叠在一起)。
只想在某几页看的话,把整段放进那几页的模板里,别放进全站页脚。
兼容性
requestAnimationFrame 全系支持,写法里已经带了 webkit / moz / ms 前缀和 setTimeout 兜底。classList、performance.now() 也都是老浏览器就有的。
visibilitychange 在很老的浏览器上不支持,只是"后台回来会闪一下",不影响使用。backdrop-filter 这里没用,避免了 Safari 的兼容坑。
代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。
作者:Flechazo
如若转载,请注明出处:维形筑网 https://wxzcw.com