System.IO 命名空間提供豐富的檔案與目錄操作 API。本文整理一個生產級 FileHelper 靜態工具類,涵蓋讀寫、附加、複製、移動、刪除、目錄建立/遞歸刪除、編碼處理等常用功能,並採用 using 確保資源正確釋放。
using System;
using System.IO;
using System.Text;
public static class FileHelper
{
#region 寫入檔案(不存在則建立,預設 UTF-8)
/// 寫入文字檔(覆寫模式)
public static void WriteFile(string path, string content, Encoding encoding = null)
{
encoding ??= Encoding.UTF8;
var dir = Path.GetDirectoryName(path);
if (!string.IsNullOrEmpty(dir) && !Directory.Exists(dir))
Directory.CreateDirectory(dir);
File.WriteAllText(path, content, encoding);
}
/// 附加文字到檔案末尾
public static void AppendFile(string path, string content, Encoding encoding = null)
{
encoding ??= Encoding.UTF8;
File.AppendAllText(path, content, encoding);
}
#endregion
#region 讀取檔案
/// 讀取全文(自動偵測編碼或指定編碼)
public static string ReadFile(string path, Encoding encoding = null)
{
if (!File.Exists(path)) return string.Empty;
encoding ??= Encoding.UTF8;
return File.ReadAllText(path, encoding);
}
/// 逐行讀取(大檔案節省記憶體)
public static IEnumerable ReadLines(string path, Encoding encoding = null)
{
encoding ??= Encoding.UTF8;
using var reader = new StreamReader(path, encoding);
string line;
while ((line = reader.ReadLine()) != null) yield return line;
}
#endregion
#region 複製、移動、刪除
public static void CopyFile(string source, string dest, bool overwrite = true)
{
var destDir = Path.GetDirectoryName(dest);
if (!string.IsNullOrEmpty(destDir) && !Directory.Exists(destDir))
Directory.CreateDirectory(destDir);
File.Copy(source, dest, overwrite);
}
public static void MoveFile(string source, string dest)
{
var destDir = Path.GetDirectoryName(dest);
if (!string.IsNullOrEmpty(destDir) && !Directory.Exists(destDir))
Directory.CreateDirectory(destDir);
File.Move(source, dest);
}
public static void DeleteFile(string path)
{
if (File.Exists(path)) File.Delete(path);
}
#endregion
#region 目錄操作
public static void EnsureDirectory(string path)
{
if (!Directory.Exists(path)) Directory.CreateDirectory(path);
}
/// 遞歸刪除目錄及所有內容
public static void DeleteDirectory(string path, bool recursive = true)
{
if (Directory.Exists(path))
Directory.Delete(path, recursive);
}
/// 取得目錄下所有檔案(含子目錄,可篩選副檔名)
public static string[] GetFiles(string path, string searchPattern = "*.*", SearchOption option = SearchOption.AllDirectories)
{
return Directory.Exists(path) ? Directory.GetFiles(path, searchPattern, option) : Array.Empty();
}
#endregion
#region 進階:串流複製大檔案(避免記憶體暴增)
public static void CopyStream(string source, string dest, int bufferSize = 81920)
{
using var src = File.OpenRead(source);
using var dst = File.Create(dest);
src.CopyTo(dst, bufferSize);
}
#endregion
#region 輔助:取得副檔名
public static string GetExtension(string fileName) => Path.GetExtension(fileName)?.ToLowerInvariant();
#endregion
}
// 寫入/附加
FileHelper.WriteFile(@"C:\Data\log.txt", "第一行\n");
FileHelper.AppendFile(@"C:\Data\log.txt", "第二行\n");
// 讀取
string all = FileHelper.ReadFile(@"C:\Data\log.txt");
foreach (var line in FileHelper.ReadLines(@"C:\Data\log.txt"))
Console.WriteLine(line);
// 複製/移動/刪除
FileHelper.CopyFile(@"C:\Data\a.txt", @"C:\Backup\a.txt");
FileHelper.MoveFile(@"C:\Data\b.txt", @"C:\Archive\b.txt");
FileHelper.DeleteFile(@"C:\Data\old.tmp");
// 目錄
FileHelper.EnsureDirectory(@"C:\NewFolder\Sub");
FileHelper.DeleteDirectory(@"C:\Temp", recursive: true);
var csFiles = FileHelper.GetFiles(@"C:\Project", "*.cs");
File.ReadAllText 會一次載入記憶體,超過 100MB 建議 StreamReader 逐行或 CopyStream。Path.Combine、GetDirectoryName、GetFileName 跨平台安全。ReadAllTextAsync、CopyToAsync,UI 應用必須使用避免凍結。封裝良好的 FileHelper 能大幅減少專案中重複的 IO 代碼,並統一編碼、錯誤處理與資源釋放策略。隨著 .NET 版本演進,優先使用 File. 靜態便利方法與非同步 API,僅在需精細控制串流時才直接操作 FileStream/StreamReader。