1. 前言
當你用 FileStream 或其他串流類別操作檔案時,事先搞懂開檔時到底會發生什麼事超重要。常常遇到檔案已經存在,你想要加資料但不想把舊的蓋掉,或是你就是要整個重寫檔案。還有時候檔案根本還沒建立,你只想讀,不想不小心弄出個空檔案。
舉例來說,如果你在寫一個日記本,目標就是把新內容加到已經存在的檔案最後面,保留所有舊資料。這時你就要用新增模式開檔。如果是 log 檔,每次啟動 app 都要重來,舊資料不能干擾新的,這時就要開檔時直接清空或沒檔案就新建。要是你只是想讀檔,通常會希望沒檔案時不要自動新建,不然會莫名其妙多個空檔案。
這些不同情境——新增、覆寫、只讀不新建——在 C# 裡都是靠 System.IO.FileMode 列舉來搞定的。每個模式都決定開檔或建檔時的行為,讓你能精準控制跟檔案互動時會發生什麼事。
2. FileMode 列舉——白話解釋
這裡是 FileMode 列舉的主要值:
| 值 | 說明 | 檔案已存在時 | 檔案不存在時 |
|---|---|---|---|
|
建立新檔案。如果檔案已存在——會丟出例外 | 錯誤 | OK,檔案建立 |
|
如果沒有就建立新檔,有的話就覆寫掉 | 覆寫 | OK,建立 |
|
開啟已存在檔案。沒檔案——丟例外 | OK,開啟 | 錯誤 |
|
有就開,沒有就新建 | OK,開啟 | OK,建立 |
|
開啟已存在檔案並清空內容(長度歸零) | OK,清空檔案 | 錯誤 |
|
開啟檔案在最後面加資料,沒檔案就新建 | OK,加在最後 | OK,建立 |
圖解:各種情境行為
flowchart TD
Start[開始]
A{檔案存在嗎?}
B1[開啟新增]
B2[建立新檔]
B3[覆寫檔案]
B4[開啟檔案]
B5[錯誤:找不到檔案]
B6[錯誤:檔案已存在]
Start --> A
A --Append, OpenOrCreate--> B1
A --Create, Truncate--> B3
A --Open, Truncate--> B4
A --CreateNew--> B6
A --Create, OpenOrCreate, Append--> B2
A --Open, Truncate--> B5
3. 各種模式開檔範例
來實作一下,假設我們有個小 app,要把問候語和日期寫進一個文字檔。我們看三種常見情境:
- A. 建立新檔案 (CreateNew)
- B. 覆寫檔案 (Create)
- C. 在檔案最後加資料 (Append)
建立新檔案 (FileMode.CreateNew)
如果檔案已經存在,這個模式保證你不能重建:程式會丟出 IOException。適合不能遺失資料或不想誤刪別人檔案的情境。
using System;
using System.IO;
string filePath = "greeting.txt";
// 嘗試建立新檔案——如果已經有會丟例外!
try
{
var stream = new FileStream(filePath, FileMode.CreateNew, FileAccess.Write);
var writer = new StreamWriter(stream);
writer.WriteLine("哈囉!這是第一筆紀錄。");
writer.WriteLine($"日期:{DateTime.Now}");
Console.WriteLine("檔案建立成功。");
writer.Close();
}
catch (IOException)
{
Console.WriteLine($"檔案 '{filePath}' 已經存在!不會覆寫它。");
}
注意:如果你第二次跑這段 code——catch 會觸發,資料不會被蓋掉。
覆寫檔案 (FileMode.Create)
這模式完全不囉嗦:有檔案就直接清空。沒檔案就新建。很適合每次都要「從零開始」的情境,比如重存報表。
using System;
using System.IO;
string filePath = "greeting.txt";
// 建立或完全覆寫檔案
var stream = new FileStream(filePath, FileMode.Create, FileAccess.Write);
var writer = new StreamWriter(stream);
writer.WriteLine("哈囉!我把檔案整個更新了 :)");
writer.WriteLine($"更新時間:{DateTime.Now}");
Console.WriteLine("檔案已建立或覆寫。");
writer.Close();
多跑幾次這段 code——檔案裡永遠只有最新的資料,舊的都沒了。
在檔案最後加資料 (FileMode.Append)
這模式超適合 log、事件紀錄、打卡等等。沒檔案就新建,有的話就加在最後。
using System;
using System.IO;
string filePath = "greeting.txt";
// 在檔案最後加新的一行
var stream = new FileStream(filePath, FileMode.Append, FileAccess.Write);
var writer = new StreamWriter(stream);
writer.WriteLine($"又一個問候!日期:{DateTime.Now}");
Console.WriteLine("已在檔案最後加新的一行。");
writer.Close();
多跑幾次這段 code,檔案會越來越長,每次新資料都在最後。
4. 怎麼選檔案開啟模式?實用建議
真實世界情境:
- Log 紀錄:幾乎都用 Append。log 被覆寫掉會讓管理員崩潰,也方便壞人滅證。
- 報表匯出:通常用 Create,避免資料夾堆一堆舊檔。
- 重要資料匯出:適合 CreateNew。有檔案就錯誤,什麼都不動。
- 讀檔:根本不需要建檔模式,用 FileMode.Open——沒檔案就代表有問題。
寫 C# code 時常用 File 類別的靜態方法,這些方法內部會自動選對的模式。例如 File.AppendAllText 永遠用 Append,File.WriteAllText 則用 Create。
5. 檔案模式與常見問題
有幾個小陷阱:
如果你用 FileMode.Create 或 FileMode.Truncate 開檔,所有內容都會被清空。要小心——不小心遺失資料的,不只新手,連老鳥都會中招。
如果你用 FileMode.Open 或 FileMode.Truncate 開不存在的檔案,會拿到 FileNotFoundException。記得用 File.Exists(path) 先檢查檔案真的有沒有。
用 Append 只能寫,不能讀。如果你要又讀又寫,可以考慮 OpenOrCreate + 對應的 FileAccess。
範例:讀寫同時進行
有時候你想又讀又寫(比如開銀行帳戶——要存錢也要查餘額)。用 FileMode.OpenOrCreate:
using System.IO;
string filePath = "balance.txt";
// 開檔可讀可寫,沒檔案就新建
var stream = new FileStream(filePath, FileMode.OpenOrCreate, FileAccess.ReadWrite);
// 這裡可以又讀又寫
6. 實用細節
檔案開啟模式流程
graph TD
A[請求檔案] --> B[選擇模式]
B --> C1[CreateNew] -->|檔案已存在| D1[錯誤]
C1 -->|檔案不存在| E1[建立]
B --> C2[Create] -->|永遠| F1[建立/覆寫]
B --> C3[Open] -->|檔案存在| G1[開啟]
C3 -->|檔案不存在| D1
B --> C4[OpenOrCreate] -->|檔案存在| G1
C4 -->|檔案不存在| E1
B --> C5[Append] -->|檔案存在| H1[開啟新增]
C5 -->|檔案不存在| E1
B --> C6[Truncate] -->|檔案存在| I1[清空]
C6 -->|檔案不存在| D1
檔案開啟模式總表
| FileMode | 檔案存在 | 檔案不存在 | 資料存取 | 會清空舊內容? |
|---|---|---|---|---|
|
例外 | 新建 | 寫入 | 不適用 |
|
覆寫 | 新建 | 寫入 | 會 |
|
開啟 | 例外 | 讀/寫 | 不會 |
|
開啟 | 新建 | 讀/寫 | 不會 |
|
清空 | 例外 | 寫入 | 會 |
|
開啟新增 | 新建 | 只能寫 | 不會(加在後面) |
跟 File 類別高階方法的比較
- File.WriteAllText(path, text) → 內部用 FileMode.Create,所以舊檔會被覆寫。
- File.AppendAllText(path, text) → 用 Append,全部加在最後。
- File.ReadAllText(path) → 開檔讀取(FileMode.Open)。
有時這些方法就夠用,但用 FileStream 明確指定模式會讓你完全掌控一切。
不同作業系統的注意事項
很多開發者沒注意到,在 Windows 上如果檔案被別的程式用寫入模式開著,可能就不能再開一次——會直接錯誤。所以要正確用 FileShare 參數來管理檔案共用(這個我們之後會再細講)。不同作業系統的鎖定和權限機制可能不一樣,但檔案開啟模式的概念是通用的。
GO TO FULL VERSION