萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js 遍歷目錄統計文件大小:優化前端資源加載的實用工具

前言

前端項目中圖片未壓縮導致加載緩慢是常見問題。本文介紹一個 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`);
});

二、使用方法

  1. 安裝 Node.js 環境
  2. 保存代碼為 scan-files.js
  3. 修改 targetDir 為要掃描的目錄路徑
  4. 運行:node scan-files.js
  5. 查看生成的 file-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 大小,運行腳本後發現:

  • 前 20 大文件均為 PNG 圖標
  • 美術導出時未勾選「壓縮」選項
  • 通知美術重新導出並啟用 TinyPNG 壓縮,體積降低 90%+
  • 頁面 Loading 消失,首屏加載提速 40%

五、擴展功能建議

功能實現思路
圖片尺寸分析引入 sharp 或 image-size 讀取寬高,計算「字節/像素」比率
重複文件檢測計算 MD5/SHA256 哈希,分組顯示重複文件
Git 歷史體積分析結合 git log --all --full-history -- 追踪大文件歷史
CI/CD 集成作為構建步驟,超過閾值文件阻斷構建並報警
可視化儀表盤生成 JSON 數據,前端用 ECharts 繪製 Treemap 矩形樹圖

六、總結

幾十行 Node.js 代碼即可構建強大的文件體積掃描工具,幫助團隊快速定位「大而不必要」的資源文件。建議納入前端工程化體系:

  • 開發階段:預提交鉤子掃描 staged 文件
  • 構建階段:CI 檢查產物體積預算
  • 維護階段:定期全量掃描生成報告

「有數據才有話語權」,用代碼替代人工排查,是前端工程化的核心思想之一。

copyright © 萬盛學電腦網 all rights reserved