必须实现IDisposable当类直接持有非托管资源或封装了IDisposable托管对象；否则易致内存泄漏或句柄耗尽，而仅含普通引用类型无需实现。
什么时候必须实现 IDisposable
当你的类直接持有非托管资源（如文件句柄、数据库连接、Socket、GDI对象）或封装了实现了 IDisposable 的托管对象（如 FileStream、HttpClient、DbContext），就必须实现 IDisposable。否则资源可能长期滞留，引发内存泄漏或句柄耗尽。
常见误判：仅含普通引用类型字段（如 List<string></string>、Dictionary<int object></int>）不需要实现 IDisposable —— GC 会自动回收它们。
Dispose() 方法的标准写法（带 finalizer 的完整模式）
只有当你**直接持有非托管资源**时，才需要写 finalizer（即析构函数）。绝大多数情况只需“托管清理”，用不着 finalizer —— 它会拖慢 GC，且执行时机不可控。
标准结构如下（注意命名、访问修饰符和空检查）：
public class ResourceManager : IDisposable
{
private bool _disposed = false;
private IntPtr _nativeHandle = IntPtr.Zero; // 示例：非托管句柄
private FileStream _fileStream;
public ResourceManager()
{
_fileStream = new FileStream("data.bin", FileMode.Open);
_nativeHandle = AllocateUnmanagedResource();
}
public void Dispose()
{
Dispose(true);
GC.SuppressFinalize(this);
}
protected virtual void Dispose(bool disposing)
{
if (_disposed) return;
if (disposing)
{
// 清理托管资源
_fileStream?.Dispose();
}
// 清理非托管资源
if (_nativeHandle != IntPtr.Zero)
{
FreeUnmanagedResource(_nativeHandle);
_nativeHandle = IntPtr.Zero;
}
_disposed = true;
}
~ResourceManager()
{
Dispose(false);
}
}
-
Dispose(bool)是核心逻辑，disposing == true表示可安全访问托管对象 - 必须调用
GC.SuppressFinalize(this)，避免 finalizer 再次触发 - 务必检查
_disposed标志，防止重复释放（尤其 finalizer 可能和显式Dispose()并发） - 非托管资源释放后应置为无效值（如
IntPtr.Zero），避免二次释放崩溃
只用托管资源？跳过 finalizer，用 using 或 DisposeAsync 更合适
如果你的类只包装了 HttpClient、MemoryStream、Timer 等托管 IDisposable 对象，无需 finalizer —— 这是高频错误。
此时只需轻量实现：
public class DataProcessor : IDisposable
{
private readonly HttpClient _httpClient = new HttpClient();
private readonly Timer _timer = new Timer();
public void Dispose()
{
_httpClient?.Dispose();
_timer?.Dispose();
}
}
更推荐做法：让调用方用 using 块控制生命周期，而不是依赖 finalizer兜底。finalizer 不是保险丝，是延迟释放的隐患。
若涉及异步 I/O（如 StreamWriter 写磁盘、HttpClient.SendAsync），优先实现 IAsyncDisposable，配合 await using：
public class AsyncDataWriter : IAsyncDisposable
{
private readonly StreamWriter _writer;
public AsyncDataWriter(Stream stream) => _writer = new StreamWriter(stream);
public async ValueTask DisposeAsync()
{
await _writer.FlushAsync();
_writer.Dispose();
}
}
容易被忽略的三个坑
这些点不报错，但会导致资源泄漏或线程不安全：
- 在
Dispose()后继续访问已释放字段（如调用Write()报ObjectDisposedException）—— 应在每个公共方法开头加if (_disposed) throw new ObjectDisposedException(GetType().Name); - 子类继承可释放类但未重写
Dispose(bool)，导致子类新增的资源无法释放 —— 记得把基类Dispose(bool)声明为virtual，子类用override - 在
Dispose()中调用虚方法（如OnDisposed()）—— 此时对象可能处于部分析构状态，虚方法分发可能出错；改用非虚回调或事件
最稳妥的做法：只在 Dispose(bool) 的 disposing == true 分支里操作托管对象，非托管资源清理逻辑保持纯函数式、无虚调用、无异常抛出（或至少用 try/catch 吞掉）。
