前端項目中圖片未壓縮導致加載緩慢是常見問題。本文介紹一個 Node.js 腳本,遞歸遍歷目錄、統計所有文件大小、按大小降序輸出報告,快速定位超大文件進行針對性壓縮優化。
var fs = require('fs');
var path = require('path');
// 1. 遞歸遍歷獲取所有文件信息
function getFileList(dir) {
var filesList = [];
readDir(dir, filesList);
return filesList;
}
function readDir(dir, filesList) {
var files = fs.readdirSync(dir); // 同步讀取,簡化流程控制
files.forEach(function(file) {
var fullPath = path.join(dir, file);
var stats = fs.statSync(fullPath);
if (stats.isDirectory()) {
readDir(fullPath, filesList); // 遞歸子目錄
} else {
filesList.push({
name: file,
path: fullPath,
size: stats.size, // 字節
sizeKB: (stats.size / 1024).toFixed(2), // KB
ext: path.extname(file).toLowerCase()
});
}
});
}
// 2. 按大小降序排序
function sortBySizeDesc(a, b) {
return b.size - a.size; // 降序
}
// 3. 生成報告文件
function writeReport(filesList, outputFile) {
var lines = filesList.map(function(item) {
return `文件名:${item.name} 大小:${item.sizeKB}KB 路徑:${item.path} 類型:${item.ext}`;
});
fs.writeFileSync(outputFile, lines.join('\n'), 'utf-8');
console.log('報告生成成功:', outputFile);
}
// 4. 主程序
var targetDir = "G:/nodejs"; // 修改為你的目標目錄
var outputFile = "file-size-report.txt";
var files = getFileList(targetDir);
files.sort(sortBySizeDesc);
writeReport(files, outputFile);
console.log('前 10 大文件:');
files.slice(0, 10).forEach(function(f, i) {
console.log(`${i+1}. ${f.name} - ${f.sizeKB} KB`);
});
scan-files.jstargetDir 為要掃描的目錄路徑node scan-files.jsfile-size-report.txt 和控制台輸出的 Top 10
const fs = require('fs');
const path = require('path');
const { pipeline } = require('stream/promises');
async function scanDirAsync(dir) {
const files = [];
const entries = await fs.promises.readdir(dir, { withFileTypes: true });
for (const entry of entries) {
const fullPath = path.join(dir, entry.name);
if (entry.isDirectory()) {
files.push(...await scanDirAsync(fullPath));
} else {
const stats = await fs.promises.stat(fullPath);
files.push({ name: entry.name, path: fullPath, size: stats.size });
}
}
return files;
}
// 使用
(async () => {
const files = await scanDirAsync('G:/project/assets');
files.sort((a,b) => b.size - a.size);
// 輸出 CSV 便於 Excel 分析
const csv = ['Name,Size(KB),Path,Extension'].concat(
files.map(f => `"${f.name}",${(f.size/1024).toFixed(2)},"${f.path}","${path.extname(f.name)}"`)
).join('\n');
await fs.promises.writeFile('report.csv', csv);
console.log('CSV 報告已生成');
})();
項目中發現 50x50px 圖標卻有 2MB 大小,運行腳本後發現:
| 功能 | 實現思路 |
|---|---|
| 圖片尺寸分析 | 引入 sharp 或 image-size 讀取寬高,計算「字節/像素」比率 |
| 重複文件檢測 | 計算 MD5/SHA256 哈希,分組顯示重複文件 |
| Git 歷史體積分析 | 結合 git log --all --full-history -- 追踪大文件歷史 |
| CI/CD 集成 | 作為構建步驟,超過閾值文件阻斷構建並報警 |
| 可視化儀表盤 | 生成 JSON 數據,前端用 ECharts 繪製 Treemap 矩形樹圖 |
幾十行 Node.js 代碼即可構建強大的文件體積掃描工具,幫助團隊快速定位「大而不必要」的資源文件。建議納入前端工程化體系:
「有數據才有話語權」,用代碼替代人工排查,是前端工程化的核心思想之一。