CodeGym /課程 /C# SELF /處理檔案時常見的例外情況

處理檔案時常見的例外情況

C# SELF
等級 38, 課堂 0
開放

1. 介紹:為什麼檔案常常「鬧脾氣」?

有沒有遇過想開啟一個文件,系統突然跳出:「找不到檔案」。或者想存檔時出現:「拒絕存取」。這些就是檔案系統會「鬧情緒」的情況。跟文字編碼出現亂碼不同,這類問題通常跟檔案系統本身有關。

可以把檔案系統想成一個大圖書館,應用程式就是圖書管理員。當它要拿檔案時,會收到不同的回覆:

  • 書(也就是檔案)不存在 — 它根本沒被建立。
  • 放書的那個區域沒了 — 所需的目錄不存在。
  • 書被上鎖或借給別人了 — 檔案被其他進程使用或沒有存取權限。
  • 書架滿了 — 磁碟空間不足,無法建立新檔案。
  • 或者例如,你想把書放到 DVD 歸還區 — 也就是執行了不被支援的操作。

在 C# 裡,這些情況會透過例外(exceptions)表現出來。開發者的工作不是眼睜睜看程式崩潰,而是預見可能的問題並妥善處理。沒有人想看到一大串莫名其妙的錯誤訊息。

我們已經熟悉 try-catch 結構。它是救生圈,能夠「接住」例外並採取對應措施,而不是讓程式直接當掉。

// 這是我們的老朋友,回顧一下 第57堂 的提醒
try
{
    // 這裡寫可能會拋例外的程式碼
    // 例如,嘗試讀取檔案
}
catch (Exception ex) // 捕捉任意例外
{
    // 這裡處理錯誤
    Console.WriteLine($"哎呀,發生錯誤: {ex.Message}");
}

今天我們會更深入特定在處理檔案時常遇到的例外。這能幫助你寫出更穩健的程式,能在檔案系統「耍脾氣」時跟它好好溝通。

例外不是 bug,而是求救訊號!

要理解:例外不一定代表你程式有錯。很多時候它只是外部環境通知你「哪裡出槌了」。檔案系統就是很典型的外部環境範例。你可能寫了一段完全正確的讀檔程式,但如果使用者在程式要讀取前刪掉了檔案,就會收到例外。這很正常!作為開發者,你的任務是教程式如何對這類情況反應。

下面我們來看在處理檔案時最常遇到的幾種「求救訊號」。

2. FileNotFoundException:檔案根本不存在

這大概是處理檔案時最常遇到的例外。當你嘗試開啟、讀取或對一個在指定路徑上不存在的檔案做操作時,就會拋出它。

生活中的例子:你請朋友從他家書架拿一本書 「C# 14 程式設計入門」,他回答:「我沒有這本書」。程式也會類似地向作業系統說:「給我 settings.txt 檔案」,系統回:「抱歉,沒有這個檔案」。

我們試着寫段程式讀取應用程式的 abracadabra.txt,如果檔案不存在,就要告訴使用者,而不是直接當掉。

try
{
    using var reader = new StreamReader("abracadabra.txt");
    Console.WriteLine(reader.ReadToEnd());
}
catch (FileNotFoundException ex)
{
    Console.WriteLine("找不到檔案: " + ex.FileName);
}

生活化的比喻:像是你去等公車,但公車不來,連小黃也不來。真是令人沮喪。

備註: 這個例外常伴隨著錯誤的路徑(例如你忘了目前工作目錄不同)而發生。

3. DirectoryNotFoundException:資料夾消失了

這個例外很像 FileNotFoundException,但針對的是目錄而不是檔案本身。比如你指定了路徑 "C:\MyDocuments\MyProject\Data\report.txt",但 Data 文件夾不存在,就會得到 DirectoryNotFoundException。

在我們的應用中,如果想把設定存到子資料夾 data(例如 "./data/app_settings.txt"),但該資料夾不存在,讀寫時就會遇到此問題。

DirectoryNotFoundException 可以像 FileNotFoundException 一樣單獨捕獲,或者被更通用的 IOException 包含。

try
{
    using var writer = new StreamWriter(@"C:\very\strange\path\file.txt");
    writer.WriteLine("Hello world");
}
catch (DirectoryNotFoundException ex)
{
    Console.WriteLine("找不到目錄!");
}

常見錯誤: 資料夾可能隨時被刪掉(例如有人清理暫存),或者你設定的寫入路徑錯誤。

4. UnauthorizedAccessException:禁止進入!

想像你要把書放到一個架子,結果看到牌子寫著「僅限員工進入」。這就是 UnauthorizedAccessException!當你的程式沒有對檔案或目錄的必要權限時會發生。可能原因包括:

  • 使用者權限不足:你試圖在只有管理員才能寫入的資料夾(比如 C:\Windows)寫檔。
  • 檔案被設定為唯讀:你嘗試修改被標為唯讀的檔案。
  • 檔案是系統或隱藏檔:對這些檔案可能有額外限制。

在企業環境或使用者把程式安裝到受保護目錄時,這種情況很常見。

下面示範嘗試在系統目錄寫入(注意:執行這段程式要小心,不要亂塞東西到系統資料夾,或在沙盒環境下試)。

try
{
    using var writer = new StreamWriter("/system/settings.conf");
    writer.WriteLine("全體學生萬歲!");
}
catch (UnauthorizedAccessException ex)
{
    Console.WriteLine("沒有對該檔案或目錄的存取權限!");
}

若你沒用管理員權限執行,上面程式通常會得到「無法存取此資料夾」之類的訊息。若以管理員身分執行,檔案可能會被建立。這說明為什麼要處理 UnauthorizedAccessException,讓使用者知道為何操作失敗。

5. IOException:檔案 I/O 的萬用「哎呀」

IOException 是與輸入/輸出操作相關的通用例外。當遇到一些 I/O 裝置或檔案系統層面的問題,而這些問題不屬於更具體的例外(像 FileNotFoundException 或 UnauthorizedAccessException)時,就會拋出它。

常見會觸發 IOException 的情況:

  • 檔案正在被其他程式使用:例如,你想刪除一個被記事本或其他程式開啟的檔案。
  • 磁碟空間不足:沒有足夠空間寫入檔案。
  • 檔案或檔案系統損壞:雖然少見,但有可能發生。
  • 網路問題:若檔案位於網路磁碟,連線中斷會導致錯誤。
  • 檔名或路徑過長:(有時會是 PathTooLongException,但也可能歸到 IOException)。

IOException 有點像處理很多問題的「萬用鑰匙」。當你捕捉到它時,應該查看它的 Message 屬性,以得到更詳細的錯誤資訊。

try
{
    using var file = new FileStream("busyfile.txt", FileMode.Open, FileAccess.ReadWrite, FileShare.None);
    // 用某種方式把檔案保持開啟
    // 同時在別處:
    using var writer = new StreamWriter("busyfile.txt");
    writer.WriteLine("嘗試寫入...");
}
catch (IOException ex)
{
    Console.WriteLine("輸入/輸出錯誤: " + ex.Message);
}

重要一點: IOException 是很多其他「檔案類」例外的基底類別。

6. 其他但同樣重要的「麻煩」

PathTooLongException

這個雖然少見,但會發生:你的路徑(或檔名/資料夾名)超過作業系統容許的長度。比方說你把整本 「戰爭與和平」 的內容放到檔名裡,Windows 可不會高興。

在 Windows 上歷史限制是完整路徑 260 個字元。新版 OS 與 .NET 支援較長路徑,但不是在所有情況下預設啟用。

try
{
    string veryLongPath = new string('a', 300); // 300 個字元!
    using var writer = new StreamWriter(veryLongPath + ".txt");
    writer.WriteLine("這檔名太長了!");
}
catch (PathTooLongException ex)
{
    Console.WriteLine("檔名或路徑太長!");
}

NotSupportedException

這是比較罕見但有點荒誕的情況:你把一個不合法的字串當成路徑給像 StreamReader 或 FileStream 的建構子,例如包含被禁止的字元,或魔法般的路徑像 C:::\wow???\file.txt。

7. 好用的小技巧

各例外負責什麼

例外 發生原因 情境範例
FileNotFoundException
找不到指定路徑的檔案 開啟不存在的檔案
DirectoryNotFoundException
找不到目錄 在已被刪除的資料夾中開檔
UnauthorizedAccessException
沒有存取權限 嘗試寫入受保護的資料夾
IOException
一般 I/O 錯誤 檔案被其他進程佔用
PathTooLongException
路徑或檔名太長 檔名/資料夾名過長
NotSupportedException
路徑格式不被支援 路徑包含禁用字元

常見錯誤與特殊情況

範例:檔案被其他進程佔用

想像你像個小駭客一樣在 Notepad 開著一個文字檔卻忘了關。這時候你的程式要寫入同一個檔案,就會遇到 IOException(或更具體的 sharing violation)。

範例:缺乏存取權限

試著把資料存到 C:\Windows 並且沒有管理員權限 — 你會得到 UnauthorizedAccessException。同樣情況也會在你以唯讀方式開啟檔案卻試圖寫入時發生。

範例:路徑不合法

在 Windows 中,檔名不能含有字元 <>:"/\|?*。若嘗試建立含有這些字元的檔案,程式會拋出 NotSupportedException(或 ArgumentException)。

範例:磁碟空間不足

這種情況通常也會拋出 IOException — 比如磁碟已滿(這也是為何偶而清理 Downloads 資料夾是好習慣)。

怎麼避免出錯:偵錯和最佳實務

  • 在嘗試開檔前用 File.Exists 和 Directory.Exists 檢查檔案/資料夾是否存在。但注意:檢查後檔案狀態可能會改變(經典 race condition)。
  • 不要完全吞掉例外(別只寫 catch { }),除非你真的只是在做嚴格的日誌記錄。至少要 log 或顯示給使用者發生了什麼。
  • 盡量捕捉具體例外(像 FileNotFoundException、DirectoryNotFoundException),而不是只捕 Exception。
  • 跨平台應用要考慮權限、路徑格式、檔名長度在 Windows、Linux、macOS 的差異。
  • 處理文字檔時務必明確指定編碼,避免亂碼或讀寫錯誤。
  • 做大量檔案操作時,採用批次(bulk)處理並對每一步做錯誤回復或重試策略。

常用例外速查表

例外 何時發生? 如何預防/處理?
FileNotFoundException
指定路徑沒有檔案 用 File.Exists 檢查或建立檔案
DirectoryNotFoundException
路徑包含不存在的目錄 檢查路徑,使用 Directory.CreateDirectory 建立目錄
UnauthorizedAccessException
沒有對檔案/資料夾的權限、檔案唯讀、被其他進程佔用 以適當使用者執行、檢查 ACL、正確關閉檔案
IOException
一般 I/O 錯誤、檔案被佔用、磁碟空間不足 使用 try-catch,避免長時間佔用檔案
PathTooLongException
路徑或檔名太長 縮短路徑,使用相對路徑
NotSupportedException
路徑格式不正確 檢查路徑字串是否包含禁用字元

流程圖:「檔案出錯時該怎麼做?」

flowchart TD
    A[對檔案進行操作] --> B{有拋出例外嗎?}
    B -- 否 --> C[操作成功完成]
    B -- 是 --> D{是哪種例外?}
    D -- FileNotFound --> E[請使用者指定正確檔案或建立它]
    D -- DirectoryNotFound --> F[建立缺失的目錄]
    D -- UnauthorizedAccess --> G[請使用者以適當權限重新執行程式]
    D -- IOException --> H[檢查是誰佔用檔案,或檢查磁碟]
    D -- PathTooLong --> I[縮短路徑]
    D -- NotSupported --> J[檢查路徑格式]
    D -- Other --> K[顯示訊息並檢查日誌]

8. 在實際應用中常見的使用範例

延伸我們的教學專案,假設有個小程式會把使用者的筆記存到檔案,然後再讀出來。

string notesPath = "notes.txt";

Console.Write("輸入一則筆記: ");
string note = Console.ReadLine();

try
{
    // 儲存筆記
    using var writer = new StreamWriter(notesPath, true, Encoding.UTF8);
    writer.WriteLine(note);

    // 讀取所有筆記
    Console.WriteLine("你的筆記:");
    using var reader = new StreamReader(notesPath, Encoding.UTF8);
    Console.WriteLine(reader.ReadToEnd());
}
catch (FileNotFoundException)
{
    Console.WriteLine("找不到筆記檔案。請嘗試手動建立它。");
}
catch (DirectoryNotFoundException)
{
    Console.WriteLine("筆記檔的路徑有誤。請確認資料夾是否存在。");
}
catch (UnauthorizedAccessException)
{
    Console.WriteLine("沒有讀寫檔案的權限。請用管理員身分執行程式。");
}
catch (IOException ex)
{
    Console.WriteLine("發生輸入/輸出錯誤: " + ex.Message);
}
catch (Exception ex)
{
    Console.WriteLine("意外錯誤: " + ex.Message);
}

這個範例展示了典型情況:程式試著把資料寫入檔案然後再讀回來。每個 catch 區塊都處理特定的錯誤類型 — 從檔案或資料夾不存在,到權限問題或一般的 I/O 錯誤。這樣程式就不會在第一次失敗時直接崩潰,而是告訴使用者發生了什麼以及可能的解法。這種做法會讓應用更可靠也更友善。

2
任務
C# SELF, 等級 38, 課堂 0
上鎖
處理 FileNotFoundException 例外
處理 FileNotFoundException 例外
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION