异常教程

C# Windows 文件系统的操作（千字长文）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在软件开发中，与操作系统交互的核心能力之一是对文件系统的操作。无论是读取配置文件、存储日志数据，还是处理用户上传的文件，掌握 C# Windows 文件系统的操作 对开发者至关重要。本文面向编程初学者和中级开发者，通过 循序渐进 的方式讲解 C# 中对文件系统的基本操作、高级功能及常见问题的解决方案。我们将结合 实际案例 和 代码示例，帮助读者快速掌握这一技能。

一、基础操作：文件的读取与写入

1.1 文件路径的表示与验证

在 Windows 系统中，文件路径通常使用反斜杠（\）分隔目录层级。例如：

C:\Users\Username\Documents\file.txt

但直接在代码中使用反斜杠时，需注意 转义字符 的问题。例如：

// 错误写法：单反斜杠会被视为转义字符  
string path = "C:\Users\Username\Documents\file.txt";  

// 正确写法：使用双反斜杠或@符号（推荐）  
string correctPath1 = "C:\\Users\\Username\\Documents\\file.txt";  
string correctPath2 = @"C:\Users\Username\Documents\file.txt";

形象比喻：路径就像一张地图的坐标，每个层级的名称必须准确，否则系统无法找到目标位置。

1.2 创建和删除文件

创建文件

使用 System.IO.File 类的 Create() 方法创建新文件：

using System.IO;  

// 在指定路径创建空文件  
File.Create(@"C:\Test\NewFile.txt");

写入文本内容

通过 StreamWriter 类将文本写入文件：

using (StreamWriter writer = new StreamWriter(@"C:\Test\Data.txt"))  
{  
    writer.WriteLine("Hello, World!");  
    writer.WriteLine("This is a test file.");  
}

读取文本内容

使用 StreamReader 类读取文件内容：

string content;  
using (StreamReader reader = new StreamReader(@"C:\Test\Data.txt"))  
{  
    content = reader.ReadToEnd();  
}  
Console.WriteLine(content);  // 输出文件内容

关键点：

  • 使用 using 语句确保资源释放（如关闭文件流）。
  • 文件路径需具备 读写权限，否则会引发异常。

1.3 文件操作的异常处理

文件操作可能因路径无效、权限不足或文件被占用而失败。通过 try-catch 块捕获异常：

try  
{  
    string text = File.ReadAllText(@"C:\Test\NonExistentFile.txt");  
}  
catch (FileNotFoundException ex)  
{  
    Console.WriteLine($"文件未找到: {ex.Message}");  
}  
catch (IOException ex)  
{  
    Console.WriteLine($"操作失败: {ex.Message}");  
}

二、进阶操作：目录管理与文件属性

2.1 目录的创建与删除

创建目录

使用 Directory.CreateDirectory() 方法递归创建多级目录：

// 创建 C:\Test\SubFolder 目录（若父目录不存在则自动创建）  
Directory.CreateDirectory(@"C:\Test\SubFolder");

删除目录

删除空目录：

Directory.Delete(@"C:\Test\EmptyFolder");

删除非空目录（需设置 true 参数）：

Directory.Delete(@"C:\Test\NonEmptyFolder", true);

2.2 文件与目录的遍历

列出指定目录下的所有文件

string[] files = Directory.GetFiles(@"C:\Test");  
foreach (string file in files)  
{  
    Console.WriteLine(file);  
}

递归遍历子目录

// 遍历 Test 目录及其所有子目录  
foreach (string dir in Directory.EnumerateDirectories(@"C:\Test", "*", SearchOption.AllDirectories))  
{  
    Console.WriteLine($"目录: {dir}");  
}

2.3 文件属性操作

获取文件大小

FileInfo fileInfo = new FileInfo(@"C:\Test\Data.txt");  
long fileSize = fileInfo.Length;  // 单位：字节

修改文件时间戳

fileInfo.CreationTime = DateTime.Now;  // 修改创建时间  
fileInfo.LastWriteTime = DateTime.Now; // 修改最后修改时间

三、高级技巧：异步操作与流处理

3.1 异步文件读写

对于大文件或需要响应式操作的场景，使用异步方法避免阻塞主线程：

async Task ReadFileAsync()  
{  
    using (StreamReader reader = new StreamReader(@"C:\Test\LargeFile.txt"))  
    {  
        string line;  
        while ((line = await reader.ReadLineAsync()) != null)  
        {  
            Console.WriteLine(line);  
        }  
    }  
}

3.2 使用 FileStream 直接操作字节流

处理二进制文件（如图片、压缩包）时，通过 FileStream 操作字节流：

// 读取二进制文件  
using (FileStream fs = new FileStream(@"C:\Test\Image.jpg", FileMode.Open))  
{  
    byte[] buffer = new byte[fs.Length];  
    fs.Read(buffer, 0, buffer.Length);  
}  

// 写入二进制文件  
using (FileStream fs = new FileStream(@"C:\Test\Output.jpg", FileMode.Create))  
{  
    byte[] data = ... // 需要写入的字节数组  
    fs.Write(data, 0, data.Length);  
}

四、常见问题与解决方案

4.1 路径格式错误

问题：路径中包含非法字符（如 ?、*）。
解决方案：

  • 使用 Path.GetInvalidPathChars() 获取非法字符列表。
  • 验证路径合法性：
if (Path.GetInvalidPathChars().Any(c => path.Contains(c)))  
{  
    Console.WriteLine("路径包含非法字符");  
}

4.2 文件被其他进程占用

问题：尝试删除或修改文件时，系统提示文件被占用。
解决方案：

  • 确保操作前关闭所有关联的文件流。
  • 使用 try-catch 块重试操作：
for (int i = 0; i < 3; i++)  
{  
    try  
    {  
        File.Delete(@"C:\Test\LockedFile.txt");  
        break;  
    }  
    catch (IOException)  
    {  
        Thread.Sleep(1000); // 等待1秒后重试  
    }  
}

五、最佳实践与注意事项

5.1 权限管理

  • 避免以管理员权限运行应用，除非必要。
  • 使用 FileIOPermission 类检查和设置文件访问权限。

5.2 路径的跨平台兼容性

虽然本文聚焦 Windows，但若需跨平台操作，可使用 NET Standard 或 Path.Combine：

string crossPlatformPath = Path.Combine("C:\\Test", "Data.txt");

5.3 性能优化

  • 大文件操作时，使用 缓冲区 或 异步流 减少内存压力。
  • 避免频繁读写磁盘，优先将数据缓存到内存中。

结论

通过本文，我们系统学习了 C# Windows 文件系统的操作 的核心知识点，从基础的文件读写到高级的异步流处理，再到问题排查与优化策略。掌握这些技能不仅能提升代码的健壮性，还能为开发复杂的文件管理工具或数据处理系统打下坚实基础。

下一步行动建议：

  1. 尝试用代码实现一个简单的文件管理器（如文件复制、批量重命名）。
  2. 探索 System.IO.FileSystemWatcher 类，监控文件系统事件。
  3. 阅读 Microsoft 官方文档，深入理解 System.IO 命名空间的全部功能。

通过实践与持续学习，您将能够灵活运用 C# Windows 文件系统的操作，应对各种开发场景的挑战。

最新发布

查看更多文章