LighthouseでCSSとJSのminifyを勧められたときの直し方
Lighthouse に「Minify CSS」「Minify JavaScript」(日本語の表示では「CSS の最小化」「JavaScript の最小化」)と出たときは、配信する前の CSS と JavaScript を minify(空白やコメントを取り除き、短く書き直すこと)すれば直ります。ページの表示を速くしたいときや、スマホで読み込む量を減らしたいときに見る項目です。
検証したページでは、esbuild で minify したファイルに差し替えると、2つの指摘がどちらも消えました。CSS と JavaScript の転送量の合計は、gzip で圧縮しないサーバーでは 844,908 バイトから 309,252 バイトに、gzip で圧縮するサーバーでは 133,324 バイトから 58,798 バイトになりました。
検証環境は Ubuntu 24.04、Node.js 22、Lighthouse 13.6.0(npm のパッケージ)、esbuild 0.28.2 です。Lighthouse はコマンドラインから既定の設定(モバイル)で、パフォーマンスのカテゴリーだけを、ページごとに1回ずつ実行しました。Chrome は Chrome for Testing 153 で、環境変数 CHROME_PATH で指定しました。ページの動きの確認には Playwright 1.63.0 を使いました。検証用のページは、Bootstrap 5.3.3 の bootstrap.css と lodash 4.17.21 の lodash.js(どちらも minify していない版)に、検証用に作った小さな CSS と JavaScript を足したものです。ページは同じ VM の中で動かした Node.js の小さなサーバーから、gzip で圧縮しない場合と、gzip(レベル 6)で圧縮する場合の2とおりで配信しました。Chrome の DevTools にある Lighthouse パネル、PageSpeed Insights、デスクトップの設定、Vite や webpack、Terser などほかのツールでの minify、WordPress のプラグイン、Brotli での圧縮は試していません。
指摘が出たページ
検証用のページは、猫の体重の記録を表にするだけのものです。読み込むファイルは次の4つです。
| ファイル | 大きさ(バイト) | 中身 |
|---|---|---|
css/bootstrap.css |
281,046 | Bootstrap の minify していない版 |
css/app.css |
477 | 検証用に作った CSS(コメント付き) |
js/lodash.js |
544,098 | lodash の minify していない版 |
js/app.js |
18,573 | 検証用に作った JavaScript(コメント付き) |
gzip で圧縮しないサーバーから配信し、Lighthouse を実行しました。結果の JSON から、minify に関わるところを小さなスクリプト(summarize.mjs)で抜き出すと、次のようになりました。
$ npx lighthouse http://localhost:8080/ --only-categories=performance --output=json --output=html --output-path=./out/src-identity --chrome-flags="--headless=new --no-sandbox" --quiet
exit: 0
$ node summarize.mjs out/src-identity.report.json
lighthouseVersion: 13.6.0 formFactor: mobile throttling: simulate
performance score: 66 FCP: 5.5 s LCP: 5.5 s TBT: 0 ms
unminified-css: score=0 scoreDisplayMode=metricSavings title="Minify CSS" displayValue="Est savings of 46 KiB" metricSavings={"FCP":300,"LCP":300}
/css/bootstrap.css totalBytes=281222 wastedBytes=46937 wastedPercent=16.7
unminified-javascript: score=0 scoreDisplayMode=metricSavings title="Minify JavaScript" displayValue="Est savings of 401 KiB" metricSavings={"FCP":2400,"LCP":2400}
/js/lodash.js totalBytes=544098 wastedBytes=398556 wastedPercent=73.3
/js/app.js totalBytes=18573 wastedBytes=12094 wastedPercent=65.1
(読み込んだファイルの一覧の行は省いています。)
HTML のレポートでは、「Minify JavaScript」の項目を開くと、ファイルごとの転送量(Transfer Size)と、減らせる見込み(Est Savings)が並びます。

検証用に作った app.css は、コメントと空白を多めに入れても一覧に出ませんでした。理由は後の節で説明します。
この2つの項目は、Lighthouse 13.6.0 の設定では「Diagnostics」(日本語の表示では「診断」)のグループに入っていて、パフォーマンスの点数への重みは 0 です。レポートにも「Unscored」と出ます。項目そのものは点数に入りませんが、ファイルが小さくなれば FCP(最初に何かが表示されるまでの時間)などの指標が変わり、点数も変わります。
esbuild で minify したファイルに差し替える
minify には esbuild を使いました。CSS と JavaScript のどちらも、--minify を付けるだけで minify できます。元のファイルを src/ に置き、minify したものを dist/ に書き出しました。
$ npx esbuild src/css/bootstrap.css src/css/app.css src/js/lodash.js src/js/app.js --minify --outdir=dist --outbase=src
dist/css/bootstrap.css 227.6kb
dist/js/lodash.js 71.1kb
dist/js/app.js 2.5kb
dist/css/app.css 155b
--outbase=src は、src/ の下のフォルダの形(css/、js/)を、そのまま dist/ の下に作るための指定です。HTML はそのまま dist/ にコピーしたので、<link> や <script> のパスは変えていません。
npx esbuild --help によると、--minify は3つの指定をまとめて有効にします。空白を取り除く --minify-whitespace、変数などの名前を短くする --minify-identifiers、同じ意味の短い書き方に直す --minify-syntax です。検証用に作った app.js は、次のように関数の名前が1文字になり、1000 は 1e3 になりました。
(function(){"use strict";function c(n){const o=n/1e3;return _.round(o,2)}function e(n){const o=n/1e3;return _.round(o,2)}...
(長いので、先頭だけを載せています。)
lodash.js の先頭の @license のコメントと、bootstrap.css の先頭の /*! で始まるコメントは、minify した後も残りました。esbuild の --help には、こうしたライセンスのコメント(legal comments)の置き場所を決める --legal-comments があり、バンドルしないときの既定値は inline(その場に残す)と書かれています。
minify した後も、ページが同じように動くかを Playwright で確かめました。表の行数(40行)、前の日より増えた行の数(19行)、平均の文、増えた行の文字の色は、minify の前と同じでした。コンソールのエラーはどちらも 0 件でした。
差し替えた後のレポート
gzip で圧縮しないサーバーと、gzip で圧縮するサーバーの両方で、元のファイルと minify したファイルを配信し、Lighthouse の結果を比べました。転送量は、Lighthouse の結果の network-requests の値です。
| 配信のしかた | CSS の転送量 | JavaScript の転送量 | 指摘 | 点数 | FCP |
|---|---|---|---|---|---|
| minify なし・gzip なし | 281,872 | 563,036 | CSS と JS の両方 | 66 | 5.5 秒 |
| minify あり・gzip なし | 233,526 | 75,726 | なし | 93 | 2.6 秒 |
| minify なし・gzip あり | 34,077 | 99,247 | CSS と JS の両方 | 99 | 1.7 秒 |
| minify あり・gzip あり | 31,353 | 27,445 | なし | 100 | 1.3 秒 |
(転送量の単位はバイトで、2つのファイルの合計です。FCP は、Lighthouse がモバイルの回線を想定して見積もった値で、1回だけ実行した結果です。)
minify したページでは、gzip のあり・なしにかかわらず、「Minify CSS」と「Minify JavaScript」はどちらも合格になり、一覧に何も出ませんでした。
減り方は、CSS と JavaScript で大きく違いました。gzip なしで比べると、lodash.js は 544,098 バイトから 72,832 バイトになりましたが、bootstrap.css は 281,046 バイトから 233,022 バイトにしかなりませんでした。gzip ありで比べると、CSS の転送量は 34,077 バイトから 31,353 バイトと、1割も減っていません。
Lighthouse の見込みは、空白とコメントの分だけ
Lighthouse 13.6.0 のコードを見ると、Lighthouse は減らせる見込みを次のように出しています。
- ファイルの中身から、空白とコメントを除いた文字数を数える(
/*!や@licenseのようなライセンスのコメントは、除かずに数える) - 除いた分の割合を、そのファイルの転送量(JavaScript はレスポンスヘッダーを除いた大きさ)に掛ける
- 割合が小さいとき(CSS は 5% 未満、JavaScript は 10% 未満)や、見込みが 2,048 バイト未満のときは、一覧に出さない
公式の解説にある「Minify CSS」の説明にも、見込みは CSS の中のコメントと空白をもとにした控えめな値で、minify するツールを使うと見込みより多く減ることがある、と書かれています。
変数の名前を短くする分は見込みに入っていないので、JavaScript は見込みより多く減りました。gzip なしの lodash.js は、見込みどおりに 398,556 バイト減ると 145,542 バイトになる計算ですが、esbuild の --minify では 72,832 バイトになりました。esbuild で空白だけを取り除く --minify-whitespace にすると 147,393 バイトで、Lighthouse の見込みに近い大きさでした。
lodash.js を esbuild で処理したとき |
大きさ | gzip の後 |
|---|---|---|
| 何もしない | 544,098 | 97,552 |
| 空白だけを取り除く | 147,393 | 36,316 |
| 空白と、短い書き方への書き直し | 144,347 | 36,019 |
--minify(名前も短くする) |
72,832 | 26,471 |
(単位はバイト。gzip はレベル 6 で圧縮した大きさです。)
逆に、gzip で配信するときの CSS は、見込みより減りませんでした。bootstrap.css の見込みは 5,592 バイトでしたが、実際の転送量は 33,507 バイトから 31,020 バイトになり、減ったのは 2,487 バイトでした。Node.js の zlib で比べても、bootstrap.css の gzip の後の大きさは、空白を取り除く前が 33,308 バイト、取り除いた後が 30,903 バイトで、差は 2,405 バイトでした。見込みは minify する前の大きさに対する割合(16.7%)を、gzip の後の転送量にそのまま掛けた値なので、実際の差とずれます。
gzip で配信すると、一覧に出るファイルが変わる
gzip で圧縮するサーバーから元のファイルを配信すると、「Minify JavaScript」の見込みは 401 KiB から 70 KiB になり、一覧から app.js が消えました。

$ node summarize.mjs out/src-gzip.report.json
lighthouseVersion: 13.6.0 formFactor: mobile throttling: simulate
performance score: 99 FCP: 1.7 s LCP: 1.7 s TBT: 10 ms
unminified-css: score=0.5 scoreDisplayMode=metricSavings title="Minify CSS" displayValue="Est savings of 5 KiB" metricSavings={"FCP":0,"LCP":0}
/css/bootstrap.css totalBytes=33507 wastedBytes=5592 wastedPercent=16.7
unminified-javascript: score=0 scoreDisplayMode=metricSavings title="Minify JavaScript" displayValue="Est savings of 70 KiB" metricSavings={"FCP":450,"LCP":450}
/js/lodash.js totalBytes=97552 wastedBytes=71458 wastedPercent=73.3
(読み込んだファイルの一覧の行は省いています。)
app.js は minify していないままで、空白とコメントの割合は 65% あります。それでも gzip の後の転送量は 1,489 バイトしかなく、その 65% でも 2,048 バイトに届かないので、一覧に出ませんでした。app.css(477 バイト)が gzip なしでも出なかったのも、同じ理由です。
このため、Lighthouse の一覧に出ていないファイルが minify 済みとは限りません。esbuild で minify すると、app.js は 18,573 バイトから 2,531 バイトになり、gzip の後の転送量も 1,489 バイトから 768 バイトになりました。
minify と gzip などの圧縮は、別々に効きます。この検証では、両方を行ったときに転送量がいちばん小さくなりました(CSS と JavaScript の合計で 58,798 バイト)。minify を済ませたら、サーバーが CSS と JavaScript を圧縮して返しているかも、レスポンスの Content-Encoding で確かめておくと安心です。





