萬盛學電腦網

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

JavaScript (WSH/JScript) 檔案系統操作完整指南

執行環境說明

本文 API 屬於 Windows Script Host (WSH) 環境(.js、.wsf 檔案雙擊或 cscript.exe / wscript.exe 執行),非瀏覽器 JavaScript。瀏覽器因安全沙箱無法直接存取本地檔案系統。

核心物件:Scripting.FileSystemObject

const fso = new ActiveXObject('Scripting.FileSystemObject');

常用操作封裝

1. 讀取文字檔

function readFile(path, encoding = 'utf-8') {
    const fso = new ActiveXObject('Scripting.FileSystemObject');
    const file = fso.OpenTextFile(path, 1, false, encoding === 'unicode' ? -1 : 0); // 1=ForReading
    const content = file.ReadAll();
    file.Close();
    return content;
}

2. 寫入/附加文字檔

function writeFile(path, content, append = false, encoding = 'utf-8') {
    const fso = new ActiveXObject('Scripting.FileSystemObject');
    // 2=ForWriting(覆寫), 8=ForAppending(附加)
    const mode = append ? 8 : 2;
    const file = fso.OpenTextFile(path, mode, true, encoding === 'unicode' ? -1 : 0); // true=create
    file.Write(content);
    file.Close();
}

3. 列出資料夾內容(遞迴/非遞迴)

function listFiles(folderPath, recursive = false) {
    const fso = new ActiveXObject('Scripting.FileSystemObject');
    const folder = fso.GetFolder(folderPath);
    const result = {files: [], folders: []};

    const enumFiles = new Enumerator(folder.Files);
    for (; !enumFiles.atEnd(); enumFiles.moveNext()) {
        result.files.push(enumFiles.item().Path);
    }

    if (recursive) {
        const enumFolders = new Enumerator(folder.SubFolders);
        for (; !enumFolders.atEnd(); enumFolders.moveNext()) {
            const sub = enumFolders.item();
            result.folders.push(sub.Path);
            // 遞迴
            const subResult = listFiles(sub.Path, true);
            result.files.push(...subResult.files);
            result.folders.push(...subResult.folders);
        }
    } else {
        const enumFolders = new Enumerator(folder.SubFolders);
        for (; !enumFolders.atEnd(); enumFolders.moveNext()) {
            result.folders.push(enumFolders.item().Path);
        }
    }
    return result;
}

4. 複寫/移動/刪除

function copyFile(src, dest, overwrite = true) {
    const fso = new ActiveXObject('Scripting.FileSystemObject');
    fso.CopyFile(src, dest, overwrite);
}

function moveFile(src, dest) {
    const fso = new ActiveXObject('Scripting.FileSystemObject');
    fso.MoveFile(src, dest);
}

function deleteFile(path) {
    const fso = new ActiveXObject('Scripting.FileSystemObject');
    if (fso.FileExists(path)) fso.DeleteFile(path);
}

function deleteFolder(path, force = true) {
    const fso = new ActiveXObject('Scripting.FileSystemObject');
    if (fso.FolderExists(path)) fso.DeleteFolder(path, force);
}

5. 取得磁碟資訊

function getDriveInfo(driveLetter = 'C:') {
    const fso = new ActiveXObject('Scripting.FileSystemObject');
    const drv = fso.GetDrive(fso.GetDriveName(driveLetter));
    return {
        letter: drv.DriveLetter,
        type: drv.DriveType, // 1=可移動, 2=固定, 3=網路, 4=光碟, 5=RAM
        fileSystem: drv.FileSystem,
        totalSize: drv.TotalSize,
        freeSpace: drv.FreeSpace,
        availableSpace: drv.AvailableSpace,
        volumeName: drv.VolumeName,
        serialNumber: drv.SerialNumber,
        isReady: drv.IsReady,
        shareName: drv.ShareName,
        path: drv.Path,
        rootFolder: drv.RootFolder
    };
}

Enumerator 迭代器模式詳解

WSH 集合(Files、Folders、SubFolders)不支援 for...of,需用 Enumerator:

const enum = new Enumerator(collection);
for (; !enum.atEnd(); enum.moveNext()) {
    const item = enum.item(); // 當前項目
    // 處理 item
}

完整範例:備份指定資料夾至另一位置

// backup.js
const src = 'D:\\Projects\\MyApp';
const dest = 'E:\\Backups\\MyApp_' + new Date().toISOString().slice(0,10).replace(/-/g,'');

const fso = new ActiveXObject('Scripting.FileSystemObject');

function copyFolderRecursive(srcPath, destPath) {
    if (!fso.FolderExists(destPath)) fso.CreateFolder(destPath);
    const srcFolder = fso.GetFolder(srcPath);

    // 複製檔案
    const eFiles = new Enumerator(srcFolder.Files);
    for (; !eFiles.atEnd(); eFiles.moveNext()) {
        const file = eFiles.item();
        fso.CopyFile(file.Path, destPath + '\\' + file.Name, true);
    }
    // 遞迴子資料夾
    const eFolders = new Enumerator(srcFolder.SubFolders);
    for (; !eFolders.atEnd(); eFolders.moveNext()) {
        const folder = eFolders.item();
        copyFolderRecursive(folder.Path, destPath + '\\' + folder.Name);
    }
}

try {
    copyFolderRecursive(src, dest);
    WScript.Echo('備份完成:' + dest);
} catch (e) {
    WScript.Echo('錯誤:' + e.message);
    WScript.Quit(1);
}

執行:cscript //nologo backup.js

現代替代方案

  • Node.js (fs 模組):跨平台、非同步、Stream、Promise 化,適合伺服器端/建置腳本
  • PowerShell:Windows 原生、管線操作強大、物件導向
  • Python (pathlib/shutil):跨平台、語法清晰、生態豐富

僅在維護舊有 WSH 自動化腳本、HTA 應用、或純 Windows 內網環境才建議繼續使用本文技術。

copyright © 萬盛學電腦網 all rights reserved