1. 複製檔案
到目前為止,我們對檔案系統的操作比較像「一刀流」:建立檔案、讀取、刪除 — 就這樣。但在現實場景常見的需求是把內容複製出去:文件備份、範本複製、資料處理自動化。複製乍看是簡單的事(Ctrl+C、Ctrl+V),但實務上有不少細節要注意。
今天我們會把所有複製檔案與資料夾的方法都過一遍 — 從最簡單的到稍微複雜一點的做法。也會看到 .NET 內建類別怎麼解這個問題、有哪些限制、可能遇到的錯誤,以及當目錄有上千個、檔案有百萬時該怎麼處理。
類別 File 和方法 Copy
最簡單的複製檔案方法是用靜態方法 File.Copy。這個方法接受來源檔路徑、目標檔路徑,以及一個可選參數:當目標已存在時是否允許覆寫。
using System.IO;
// 簡單的檔案複製範例
File.Copy("source.txt", "destination.txt");
如果目標檔已存在,方法會丟出例外。要明確允許覆寫,使用第三個參數:
File.Copy("source.txt", "destination.txt", overwrite: true);
重要提示: 如果第二個參數("destination.txt")實際上是已存在的目錄路徑,而不是檔案,會發生錯誤。這個方法期望的是一個檔案的路徑!
路徑處理
像平常一樣,別忘了用 Path.Combine,避免被多餘或錯誤的斜線搞慘:
string sourcePath = Path.Combine("Data", "input.txt");
string destPath = Path.Combine("Backup", "input_backup.txt");
File.Copy(sourcePath, destPath, overwrite: true);
錯誤處理
複製檔案時可能出錯的情況很多:檔案可能被其他程序鎖住、來源檔不存在、沒有權限、目標磁碟已滿。要使用例外處理:
try
{
File.Copy("bigdata.txt", "bigdata_backup.txt", overwrite: false);
Console.WriteLine("檔案複製成功!");
}
catch (IOException ex)
{
Console.WriteLine($"輸入輸出錯誤:{ex.Message}");
}
catch (UnauthorizedAccessException)
{
Console.WriteLine("沒有檔案或資料夾的存取權限。");
}
catch (Exception ex)
{
Console.WriteLine($"其他錯誤:{ex.Message}");
}
類別 FileInfo 和方法 CopyTo
如果你已經有一個 FileInfo 物件,可以在它上面呼叫 CopyTo:
var fi = new FileInfo("report.xlsx");
fi.CopyTo("backup_report.xlsx");
第三個引數(overwrite)在 CopyTo 是從 .NET Core 2.0+ 才有的,所以如果你寫的是舊版 framework,看到錯誤別驚訝。
把檔案「複製到不存在的地方」
要注意目標路徑是否存在。如果目標資料夾不存在,.NET 會拋錯。因此在複製前最好確保接收資料夾已存在:
string backupDir = "Backup";
if (!Directory.Exists(backupDir))
{
Directory.CreateDirectory(backupDir);
}
string targetPath = Path.Combine(backupDir, "mydoc.txt");
File.Copy("mydoc.txt", targetPath);
2. 複製目錄:不是給薄弱心臟的任務
這裡才是真正的冒險開始!.NET 沒有內建一個「魔法」方法 Directory.Copy(像 File 那樣一行搞定)。我們得自己動手寫遞迴函式來複製所有檔案和子資料夾。
為什麼沒有 Directory.Copy?
目錄複製並不總是單純的事。每個資料夾可能有檔案、子資料夾、隱藏檔、特殊權限或超長路徑。開發者決定讓程式設計師自己選擇要怎麼複製。但我們懶得走捷徑——直接寫自己的函式!
遞迴複製目錄的範例
任務: 將一個資料夾(以及它的整個子世界)複製到另一個位置。
using System;
using System.IO;
void CopyDirectory(string sourceDir, string destDir, bool recursive)
{
// 檢查來源資料夾是否存在
if (!Directory.Exists(sourceDir))
throw new DirectoryNotFoundException($"來源資料夾未找到:{sourceDir}");
// 如果目的資料夾還沒存在就建立
if (!Directory.Exists(destDir))
Directory.CreateDirectory(destDir);
// 複製所有檔案
foreach (string filePath in Directory.GetFiles(sourceDir))
{
string fileName = Path.GetFileName(filePath);
string destFilePath = Path.Combine(destDir, fileName);
File.Copy(filePath, destFilePath, overwrite: true);
}
// 如果需要遞迴 — 複製所有子資料夾
if (recursive)
{
foreach (string dirPath in Directory.GetDirectories(sourceDir))
{
string dirName = Path.GetFileName(dirPath);
string destSubDir = Path.Combine(destDir, dirName);
// 遞迴呼叫!
CopyDirectory(dirPath, destSubDir, recursive);
}
}
}
使用:
CopyDirectory("C:\\MyData", "D:\\Backup\\MyData", recursive: true);
此函式會建立目錄結構並複製所有檔案,包括子資料夾的內容。
剖析程式碼與注意事項
我們先建立目的資料夾(如果不存在)——否則在複製檔案時會出錯。在每個迴圈裡用 Path.GetFileName,以免在組合新路徑時丟失檔名或資料夾名。
順帶一提,如果你把目錄複製到它自己或它的子資料夾,會進入無盡遞迴……然後得到 StackOverflowException。不要把 "C:\\Data" 複製到 "C:\\Data\\Backup"。電腦會不高興!
只複製檔案(不含子資料夾)
有時只需要複製頂層檔案(不進子資料夾):
void CopyFilesOnly(string sourceDir, string destDir)
{
if (!Directory.Exists(destDir))
Directory.CreateDirectory(destDir);
foreach (string filePath in Directory.GetFiles(sourceDir))
{
string fileName = Path.GetFileName(filePath);
string destFilePath = Path.Combine(destDir, fileName);
File.Copy(filePath, destFilePath, overwrite: true);
}
}
示例 — 實作備份功能
把這功能加到我們整個課程中維護的「家用應用程式」裡。讓它會把資料做備份。
using System;
using System.IO;
namespace HomeApp
{
class Program
{
static void CopyDirectory(string sourceDir, string destDir, bool recursive)
{
if (!Directory.Exists(sourceDir))
throw new DirectoryNotFoundException($"來源資料夾未找到:{sourceDir}");
if (!Directory.Exists(destDir))
Directory.CreateDirectory(destDir);
foreach (string filePath in Directory.GetFiles(sourceDir))
{
string fileName = Path.GetFileName(filePath);
string destFilePath = Path.Combine(destDir, fileName);
File.Copy(filePath, destFilePath, overwrite: true);
}
if (recursive)
{
foreach (string dirPath in Directory.GetDirectories(sourceDir))
{
string dirName = Path.GetFileName(dirPath);
string destSubDir = Path.Combine(destDir, dirName);
CopyDirectory(dirPath, destSubDir, recursive);
}
}
}
static void Main(string[] args)
{
Console.WriteLine("請輸入工作目錄的路徑:");
string source = Console.ReadLine()!;
Console.WriteLine("請輸入備份資料夾的路徑:");
string dest = Console.ReadLine()!;
try
{
CopyDirectory(source, dest, recursive: true);
Console.WriteLine("備份已成功建立!");
}
catch (Exception ex)
{
Console.WriteLine("複製時發生錯誤: " + ex.Message);
}
}
}
}
3. 有用的小提示
比較:檔案 vs 目錄 — 表格
| 檔案 | 目錄 | |
|---|---|---|
| 內建方法 | |
- |
| 物件導向方式 | |
- |
| 處理巢狀結構 | 不需要 | 需要遞迴 |
| 建立結構 | 自動 | 需手動建立巢狀結構 |
| 遞迴風險 | 沒有 | 有 — 不要複製「自己到自己」 |
實務應用與練習題
複製檔案與資料夾的任務到處都是:從備份、資料遷移到遊戲啟動器的資源更新。這些流程通常會被自動化,以避免人工錯漏或早上忘記備份的尷尬。
目錄複製在需要保留不只是內容,還要保留結構(含子資料夾、巢狀檔案、設定檔)時非常有用。
複製檢查清單(避免出包)
- 來源是否存在
- 目的資料夾是否存在(需要時用 Directory.CreateDirectory 建立)
- 檔案覆寫策略 — 是否需要 overwrite: true?
- 不要把資料夾「複製到自己身上」
- 有沒有超過路徑長度限制(特別是在 Windows)?
- 是否考慮到隱藏檔 / 系統檔?
4. 複製時的特殊情況與常見錯誤
存取權限
如果你的程式沒有讀取來源檔或寫入目的資料夾的權限,複製會失敗,並可能拋出各種 UnauthorizedAccessException。解法包括以管理員身分執行程式(只有在必要時)或選擇合適的目錄來操作。
檔案被佔用
如果檔案被其他程式開啟(例如 Excel 把它鎖住),File.Copy 會拋例外。確認沒有程式在鎖檔,或實作重試機制(try-catch 加上 retry)。
覆寫策略
要不要覆寫已存在的檔案?備份通常允許覆寫(overwrite: true),而複製範本時通常不覆寫(overwrite: false)。
隱藏檔與系統檔的複製
預設我們用的那些方法(例如 Directory.GetFiles)會回傳所有檔案,包括隱藏與系統檔。如果要跳過它們,明確做過濾:
foreach (string filePath in Directory.GetFiles(sourceDir))
{
var attr = File.GetAttributes(filePath);
if ((attr & FileAttributes.Hidden) == FileAttributes.Hidden)
continue; // 跳過隱藏檔
// 其餘的複製程式碼
}
路徑長度錯誤
Windows 長期有約 260 字元的路徑限制。新版系統可以解除這限制,但如果你在舊系統上工作,超長路徑會造成問題。
符號連結與 junctions
在特定情況下目錄內會有符號連結或 junction。一般複製方法可能會把它們當成一般資料夾複製,或忽略它們。對大多數教學場景不重要,但處理系統目錄時要特別小心。
GO TO FULL VERSION