CodeGym /課程 /C# SELF /批量檔案操作

批量檔案操作

C# SELF
等級 40, 課堂 4
開放

1. 介紹

想像一個存了好幾年照片的資料夾 —— 數千個檔案在同一個資料夾裡(Windows 使用者常見場景),現在的任務是:把今年建立的 .jpg 檔案複製到另一個資料夾進行處理。或者你需要把所有報告檔案加上前綴 "old_",以區分舊版和新版。即使你不常處理相簿,批量操作在任何需要處理資料、日誌、備份或自動化的專案中都會遇到。面試題也常出現!

批量操作是練習好幾件事的好機會:

  • 用迴圈和 LINQ 遍歷目錄內容
  • 練習處理路徑(Path)
  • 過濾、搜尋、依模式重新命名的基礎
  • 重要議題:安全性、錯誤、覆寫策略

開始吧 — 願你有力量戰勝檔案混亂!

2. 批量複製檔案

原理:一般流程

批量操作通常要做的事:

  1. 取得需要的檔案清單(例如,資料夾裡所有 .txt)
  2. 對每個檔案執行需要的操作(複製、刪除等)

可以用下面方式實作:

  • Directory.GetFiles() — 取得檔案清單,
  • 用 foreach 迴圈 — 逐一處理每個檔案。

範例:將資料夾中所有 .txt 檔案複製到另一個資料夾


string sourceDir = @"C:\Source";
string destDir = @"C:\Target";

// 取得來源資料夾所有 .txt 檔案
string[] txtFiles = Directory.GetFiles(sourceDir, "*.txt");

foreach (string srcPath in txtFiles)
{
    // 從完整路徑取得檔名
    string fileName = Path.GetFileName(srcPath);

    // 組成目標資料夾的完整路徑
    string destPath = Path.Combine(destDir, fileName);

    // 複製檔案
    File.Copy(srcPath, destPath, overwrite: true); // overwrite - 如果檔案已存在就覆寫
    Console.WriteLine($"Copied: {fileName}");
}

Console.WriteLine("所有 .txt 檔案已成功複製!");

注意:範例中使用了篩選 "*.txt" —— 這是像 Windows 一樣的檔名搜尋模式。

視覺化(示意圖)

+----------------+     [*.txt]     +----------------+
|   C:\Source    | ---filter-----> |   C:\Target    |
| a.txt          |   foreach +     |                |
| b.txt          | --copy--------> | a.txt (copied) |
| c.jpg          |                | b.txt (copied) |
+----------------+                +----------------+
(.jpg 檔案被忽略,只複製 .txt)

3. 批量刪除檔案

批量刪除檔案是很常見的操作。例如,清理暫存檔、定期刪除舊日誌或不需要的 jpg 照片。

範例:刪除所有超過 30 天的檔案


string dir = @"C:\MyLogs";
int daysOld = 30;

DirectoryInfo di = new DirectoryInfo(dir);
// 取得資料夾裡所有檔案
foreach (FileInfo file in di.GetFiles())
{
    // 檢查最後修改時間
    if (file.LastWriteTime < DateTime.Now.AddDays(-daysOld))
    {
        file.Delete();
        Console.WriteLine($"已刪除: {file.Name}");
    }
}

小技巧:FileInfo.LastWriteTime 很方便用於判斷「超過 N 天」的條件。

4. 批量重新命名檔案

有時需要依模式重命名大量檔案。例如,加上共同前綴、更改副檔名,或順序編號。在 .NET 裡一樣是先拿到檔案清單,然後用 File.Move() 做重新命名。

範例:給所有 .docx 檔案加上前綴 "old_"


string dir = @"C:\Reports";

string[] docxFiles = Directory.GetFiles(dir, "*.docx");
foreach (string oldPath in docxFiles)
{
    string dirPath = Path.GetDirectoryName(oldPath)!;
    string fileName = Path.GetFileName(oldPath);
    string newPath = Path.Combine(dirPath, "old_" + fileName);

    // 重新命名(實際上是移動到同一個資料夾但新的名稱)
    File.Move(oldPath, newPath);
    Console.WriteLine($"已重新命名: {fileName} -> old_{fileName}");
}

重點:如果目標檔名已經存在,會拋出例外。必要時可以在裡面用 try-catch 來處理。

5. 複製整個目錄及其內容

對於單一資料夾的簡單操作沒有「一行複製整個資料夾」的內建方法(注意 Directory.Copy 並不存在 — 這是給資深者的坑!)。通常要手動做到:

  1. 建立目標資料夾(若不存在)
  2. 複製所有檔案(參考前面的範例)
  3. 遞迴複製所有子資料夾(每個子資料夾當作新的複製任務處理)

通用函式:遞迴複製資料夾


using System;
using System.IO;

class Program
{
    static void CopyDirectory(string sourceDir, string destDir, bool overwrite = true)
    {
        // 建立目標資料夾(如果不存在)
        Directory.CreateDirectory(destDir);

        // 複製所有檔案
        foreach (string filePath in Directory.GetFiles(sourceDir))
        {
            string fileName = Path.GetFileName(filePath);
            string destFile = Path.Combine(destDir, fileName);
            File.Copy(filePath, destFile, overwrite);
        }

        // 遞迴複製所有子資料夾
        foreach (string subDir in Directory.GetDirectories(sourceDir))
        {
            string dirName = Path.GetFileName(subDir);
            string destSubDir = Path.Combine(destDir, dirName);
            CopyDirectory(subDir, destSubDir, overwrite);
        }
    }

    static void Main()
    {
        string source = @"C:\Archive2023";
        string target = @"D:\Backup2023";
        CopyDirectory(source, target);
        Console.WriteLine("資料夾已成功複製!");
    }
}

流程圖

            CopyDirectory(A, B)
               /          \
      copy files        foreach subDir -> CopyDirectory(subDir, destSubDir)

6. 批量過濾、搜尋與處理檔案

假設你不只想遍歷資料夾,而是用多重條件挑選:例如,只選出大小超過 5 MB、且建立於 2024 年的圖片!這時把 LINQ 與檔案系統類別結合就很方便。

範例:列出大型且新鮮的圖片檔名


string dir = @"C:\Pictures";

var filtered = new DirectoryInfo(dir)
    .GetFiles("*.jpg")
    .Where(f => f.Length > 5_000_000 && f.CreationTime.Year == 2024);

foreach (var file in filtered)
{
    Console.WriteLine($"{file.Name} ({file.Length / 1024 / 1024} MB)");
}

這個範例用 LINQ 做串接式過濾 —— 很貼近實務中會寫的程式碼。

7. 遍歷巢狀資料夾:遞迴與列舉

經常不只要處理單一資料夾,而是整個樹狀結構(例如,遞迴刪除所有暫存檔)。取得檔案的方法(Directory.GetFiles 和 DirectoryInfo.GetFiles)有支援一個參數 SearchOption.AllDirectories,可以幫你一次性搜尋所有子目錄!

範例:在所有子目錄中找到並刪除所有 .tmp 檔案


string root = @"D:\BigFolder";
string[] tmpFiles = Directory.GetFiles(root, "*.tmp", SearchOption.AllDirectories);

foreach (string file in tmpFiles)
{
    File.Delete(file);
    Console.WriteLine($"已刪除: {file}");
}
Console.WriteLine("所有暫存檔已刪除。");

注意:使用這個選項要小心 —— 它可能會找到非常深層的檔案!

8. 批量建立檔案與資料夾

有時候任務是相反的:自動建立所需的目錄結構或產生大量檔案。

範例:建立 10 個資料夾,每個裡面建立 10 個檔案


string root = @"C:\GeneratedFolders";

for (int i = 1; i <= 10; i++)
{
    string subDir = Path.Combine(root, $"Folder_{i}");
    Directory.CreateDirectory(subDir);

    for (int j = 1; j <= 10; j++)
    {
        string filePath = Path.Combine(subDir, $"File_{j}.txt");
        File.WriteAllText(filePath, $"這是第 {j} 個檔案,位於資料夾 {i}");
    }
}

Console.WriteLine("資料夾和檔案已建立!");

小技巧:可以快速建立測試用的基礎設施,為測試或教學生成「假資料」。

9. 批量移動檔案

和複製類似,但使用 File.Move 代替 File.Copy。很適合把檔案依類型整理到不同資料夾。

範例:依副檔名把檔案分類

情境:資料夾裡有各種型別的檔案,你想把它們依 .jpg、.pdf、.docx 等分類到不同資料夾。


string source = @"C:\Downloads";
string[] files = Directory.GetFiles(source);

foreach (string path in files)
{
    string ext = Path.GetExtension(path).TrimStart('.').ToUpper(); // "JPG", "PDF", "DOCX"
    if (string.IsNullOrEmpty(ext)) ext = "OTHER";
    string destDir = Path.Combine(source, ext);

    Directory.CreateDirectory(destDir); // 不怕資料夾已存在

    string fileName = Path.GetFileName(path);
    string destPath = Path.Combine(destDir, fileName);

    if (!File.Exists(destPath))
    {
        File.Move(path, destPath);
        Console.WriteLine($"已移動: {fileName} -> {destDir}");
    }
    else
    {
        Console.WriteLine($"目標 {destDir} 已有此檔案,跳過: {fileName}");
    }
}

檔案會被分門別類,你會覺得自己像數位版的 Marie Kondo(斷捨離大師)。

10. 常見錯誤與批量操作的細節

當你不是處理單一檔案,而是上百個時,會遇到一些有趣的細節問題。

例如,有些檔案可能被其他程式佔用 —— 嘗試刪除或複製會失敗。還有目標資料夾已經存在相同檔名的情況。如果程式沒有處理覆寫邏輯,就會拋例外。有時候檔案或資料夾會缺乏權限,或不小心遞迴刪除到重要資料。

典型錯誤是沒有在迴圈內處理錯誤:如果中間某個檔案發生問題(例如沒有權限),整個循環會中斷,後續檔案就沒辦法處理。因此穩健的批量操作通常會在迴圈內使用 try-catch 來跳過有問題的檔案,讓其他檔案能繼續處理。

別忘了覆寫參數:在合適的地方於 File.Copy 使用 overwrite: true,而在重新命名/移動時要先檢查目標路徑是否存在,或採用衝突策略(加後綴重新命名、跳過或記錄衝突)。

2
任務
C# SELF, 等級 40, 課堂 4
上鎖
依據副檔名將檔案分類到不同資料夾
依據副檔名將檔案分類到不同資料夾
1
問卷/小測驗
建立與刪除檔案,等級 40,課堂 4
未開放
建立與刪除檔案
檔案與目錄管理
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION