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. 好用的小技巧
各例外負責什麼
| 例外 | 發生原因 | 情境範例 |
|---|---|---|
|
找不到指定路徑的檔案 | 開啟不存在的檔案 |
|
找不到目錄 | 在已被刪除的資料夾中開檔 |
|
沒有存取權限 | 嘗試寫入受保護的資料夾 |
|
一般 I/O 錯誤 | 檔案被其他進程佔用 |
|
路徑或檔名太長 | 檔名/資料夾名過長 |
|
路徑格式不被支援 | 路徑包含禁用字元 |
常見錯誤與特殊情況
範例:檔案被其他進程佔用
想像你像個小駭客一樣在 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)處理並對每一步做錯誤回復或重試策略。
常用例外速查表
| 例外 | 何時發生? | 如何預防/處理? |
|---|---|---|
|
指定路徑沒有檔案 | 用 File.Exists 檢查或建立檔案 |
|
路徑包含不存在的目錄 | 檢查路徑,使用 Directory.CreateDirectory 建立目錄 |
|
沒有對檔案/資料夾的權限、檔案唯讀、被其他進程佔用 | 以適當使用者執行、檢查 ACL、正確關閉檔案 |
|
一般 I/O 錯誤、檔案被佔用、磁碟空間不足 | 使用 try-catch,避免長時間佔用檔案 |
|
路徑或檔名太長 | 縮短路徑,使用相對路徑 |
|
路徑格式不正確 | 檢查路徑字串是否包含禁用字元 |
流程圖:「檔案出錯時該怎麼做?」
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 錯誤。這樣程式就不會在第一次失敗時直接崩潰,而是告訴使用者發生了什麼以及可能的解法。這種做法會讓應用更可靠也更友善。
GO TO FULL VERSION