C# FileStream 写入文件到磁盘的方法与注意事项

顾言

发布时间：2026-10-14| 5人浏览过

原创

本文介绍了在 C# 编程语言中，如何利用 FileStream 和 StreamWriter 类将数据写入本地文件的具体方法。通过构建标准的文件流对象并进行写操作，同时强调正确关闭流以防止资源泄漏的重要性。

核心原理

在 C# 中进行文件写入通常涉及两个关键类：System.IO.FileStream 负责底层的字节流处理，而 System.IO.StreamWriter 则封装了字符集的转换，方便直接写入字符串。这种组合提供了灵活的文件访问控制能力，支持指定文件是否存在时是追加还是覆盖。

操作步骤

第一步：添加必要的命名空间

在使用文件流之前，需要确保文件中包含了基础的输入输出库引用。主要依赖以下两个命名空间：

System.IO：提供文件和流类的定义。
System：包含基本类型定义。

第二步：初始化 FileStream 对象

首先需要创建 FileStream 实例。构造函数通常接受三个参数：文件路径、文件模式（如 FileMode.OpenOrCreate）以及访问权限（如 FileAccess.Write）。这一步确立了与目标文件的连接。

第三步：配置 StreamWriter

将 FileStream 对象作为参数传递给 StreamWriter 的构造函数。这样做的目的是让 StreamWriter 能够在底层流的基础上进行更高级的字符写入操作。

第四步：执行写入操作

调用 StreamWriter 的 WriteLine 方法可以将字符串数据添加到文件末尾。注意，每次写入的内容取决于文件之前的状态以及打开模式。

第五步：安全释放资源

由于流对象实现了 IDisposable 接口，使用完毕后必须手动调用 Close() 或 Dispose() 方法，或者使用 using 语句。否则可能导致文件句柄未释放，引发“文件被占用”错误。

完整代码示例

以下是基于上述步骤的完整 C# 控制台应用程序代码。该代码展示了如何在 c:\tmp\ 目录下创建一个名为 WriteFileStuff.txt 的文件并写入一行文本。

using System;
using System.IO;

public class WriteFileStuff {
    public static void Main() {
        // 定义文件路径，建议使用 Path.Combine 处理跨平台兼容性问题
        string filePath = "c:\\tmp\\WriteFileStuff.txt";
        
        try {
            // 1. 创建 FileStream，如果文件不存在则创建，存在则保留
            using (FileStream fs = new FileStream(filePath, FileMode.OpenOrCreate, FileAccess.Write)) {
                // 2. 创建 StreamWriter 关联到该文件流
                using (StreamWriter sw = new StreamWriter(fs)) {
                    // 3. 执行写入操作
                    sw.WriteLine("Howdy World.");
                }
                // sw.Close() 在此处自动由 using 隐式调用
            }
            // fs.Close() 在此处自动由 using 隐式调用
        } catch (Exception ex) {
            Console.WriteLine($"发生错误: {ex.Message}");
        }
    }
}

注：原文中的代码使用了显式的 try-finally 块来检查并关闭流。在现代 C# 版本中，推荐使用 using 语句，它能自动处理资源的清理，使代码更加简洁且不易出错。