dispose方法不会被自动调用，必须显式调用或使用using语句；正确实现需采用dispose(bool)模板，区分托管与非托管资源释放，并通过_disposed标记和gc.suppressfinalize()避免重复释放。
为什么你的 Dispose 方法没被调用？
因为 IDisposable 不是自动触发的魔法接口——它只在你显式调用 Dispose()、或用 using 语句块包裹对象时才执行。.NET 不会为普通变量生命周期自动调用它，GC 也不会等你写完 Finalize 才回收内存。
常见错误现象：FileStream 写完没关，下次访问报“文件正由另一进程使用”；数据库连接未释放，连接池耗尽；自定义资源（如独占硬件句柄）泄漏导致后续初始化失败。
- 必须手动确保
Dispose()被调用，最安全的方式是用using块（编译器会生成try/finally） - 如果类本身持有非托管资源（如
IntPtr），需同时实现 finalizer（即析构函数~MyClass()），但仅作兜底，不能依赖它及时释放 - 已调用过
Dispose()的对象，再次调用应静默忽略（避免抛异常），可通过私有字段_disposed标记状态
如何正确实现 IDisposable 模板？
不要手写裸 Dispose() 方法。标准模式是「Dispose(bool disposing)」双参数模板，区分托管与非托管资源释放时机。
关键点在于：当 disposing == true 时，可安全调用其他托管对象的 Dispose()；当 disposing == false（即 finalizer 调用），只能释放非托管资源，绝不能访问任何托管对象（可能已被 GC 回收）。
private bool _disposed = false;
<p>public void Dispose()
{
Dispose(true);
GC.SuppressFinalize(this); // 防止 finalizer 再次执行
}</p><p>protected virtual void Dispose(bool disposing)
{
if (_disposed) return;
if (disposing)
{
// 释放托管资源：如 _stream?.Dispose(), _context?.Dispose()
_stream?.Dispose();
}
// 释放非托管资源：如 CloseHandle(_handle), FreeHGlobal(_ptr)
if (_handle != IntPtr.Zero)
{
CloseHandle(_handle);
_handle = IntPtr.Zero;
}
_disposed = true;
}</p><p>~MyResourceHolder() => Dispose(false); // finalizer 只传 false
</p>
using 语句不是万能的 —— 这些情况要小心
using 看似简单，但容易在异常传播、异步、返回引用等场景失效。
- 如果
using块内抛出异常，Dispose()仍会执行（这是设计目标），但如果Dispose()自己也抛异常，会覆盖原始异常 —— 生产环境务必在Dispose(bool)中用try/catch吞掉非关键异常 -
async/await下不能直接using var x = new FileStream(...)（C# 8+ 支持，但需确认目标框架支持）；若用旧语法，得写成using (var x = ...)+await在块内，否则Dispose()可能在 await 返回前就调了 - 不要从
using块中return出一个仍需使用的对象（比如返回MemoryStream的GetBuffer()结果），此时流已释放，缓冲区可能被回收或重用
哪些类型必须实现 IDisposable？
不是“用了资源就要实现”，而是“你直接持有需显式释放的资源”才需要。.NET BCL 中绝大多数封装了底层资源的类型都已实现 IDisposable，你只需消费它们，而非重复造轮子。
- 必须自己实现：封装了
IntPtr、Win32 句柄、OpenGL 上下文、自定义内存池指针等非托管资源的类 - 通常不需要实现：纯托管类（如
List<t></t>、StringBuilder）、只读数据容器、DTO 对象 - 注意陷阱：继承了
IDisposable类型（如Stream）的子类，必须重写Dispose()并调用基类方法，否则基类资源不释放
真正容易被忽略的是：跨线程共享的资源持有者（比如一个全局 SerialPort 实例），它的 Dispose() 可能被多线程并发调用 —— 此时 _disposed 标记和资源释放逻辑需加锁或用 Interlocked 保证原子性。
