最稳方式是直接调用 dicomfile.open()，它自动处理传输语法、字节序及隐式/显式vr等细节，避免手动解析文件头出错；需确保流位置重置、路径权限正确，并用dicomloadoptions.default仅加载元数据。
用 DicomFile.Open() 读取 DICOM 文件元数据最稳
直接调用 DicomFile.Open() 是获取元数据最可靠的方式，它会自动处理传输语法、字节序和隐式/显式 VR 等底层细节。别自己用 FileStream + BinaryReader 去硬解析——DICOM 文件头结构松散，前128字节+“DICM”标记后才是真正的数据集，手动跳过容易错位。
常见错误现象：DicomDataset.Load() 报 ArgumentException: Invalid DICOM file，往往是因为传入了未校验的原始流（比如从 HTTP 响应直接读取但没重置 Position）。
- 确保文件路径存在且有读权限；网络流需先
stream.Position = 0 - 若只需元数据，加
DicomLoadOptions.Default即可，不用设LoadPixelData = true - 遇到压缩传输语法（如
JPEG Lossless），Open()仍能读元数据，但像素解码会失败——这是预期行为，不是 bug
提取像素数据必须检查 TransferSyntax 和 PhotometricInterpretation
拿到 DicomFile.Dataset 后，不能直接认为 dataset.Get<string>(DicomTag.PhotometricInterpretation)</string> 返回值就等于显示方式。很多设备写错这个字段（比如把 MONOCHROME2 写成 MONOCHROME1），导致窗宽窗位拉伸方向反了。
真正关键的是：先看 dataset.FileMetaInfo.TransferSyntax 是否支持本地解码（如 ExplicitVRLittleEndian 可直读，JPEG2000Lossless 需额外插件）；再结合 SamplesPerPixel、BitsAllocated、PixelRepresentation 推导实际内存布局。
-
BitsAllocated == 16且PixelRepresentation == 1→ 有符号 short，别用ushort[]强转 -
PhotometricInterpretation == "RGB"时，SamplesPerPixel == 3，但像素数据未必是 RRGGBB 连续排列——得看PlanarConfiguration == 0（默认）还是1 - 用
dataset.GetPixelData().Fragment(0)拿原始字节，比dataset.Get<t>(DicomTag.PixelData)</t>更安全，后者在分帧或压缩时可能返回 null
用 fo-dicom 解码 JPEG 压缩像素要装对 NuGet 包
默认的 fo-dicom 不带 JPEG 解码器，直接调 pixelData.RenderImage() 会抛 DicomCodecException: No codec registered for transfer syntax。这不是配置问题，是缺依赖。
必须按压缩类型装对应扩展包：fo-dicom.Codecs（含全部主流编解码器）或更轻量的 fo-dicom.Codecs.Native（仅 Windows x64 原生实现）。注意 fo-dicom.Desktop 已废弃，别用。
- 安装
fo-dicom.Codecs后，在程序启动时加一行Codec.RegisterCodecs(); - Linux/macOS 下
fo-dicom.Codecs.Native不可用，只能用纯托管的fo-dicom.Codecs，性能略低但兼容 - 如果只处理非压缩图像，不装任何 Codec 包也能跑通，别为省事提前引入冗余依赖
DicomImage.RenderImage() 渲染结果发灰？重点查 WindowCenter 和 WindowWidth
医疗影像默认不应用窗宽窗位，RenderImage() 输出的是原始灰度映射到 0–255 的结果，对 CT/MR 来说通常极暗或全白。这不是渲染失败，是没传窗宽参数。
正确做法是显式传入窗值：用 dataset.Get<double>(DicomTag.WindowCenter)</double> 和 dataset.Get<double>(DicomTag.WindowWidth)</double>，再构造 new DicomImage(dataset).RenderImage(windowCenter, windowWidth)。但要注意——这两个标签可能不存在，或有多个值（多窗设置），此时需 fallback 到 dataset.Get<double>(DicomTag.RescaleIntercept)</double> 和 dataset.Get<double>(DicomTag.RescaleSlope)</double> 做线性变换。
- 若
WindowCenter是数组（如double[2]），取第一个值即可，第二个常用于双窗对比 -
RescaleIntercept/Slope是 CT 值转 HU 的必需参数，漏掉会导致整个亮度偏移 - 用
RenderImage()前务必确认dataset.InternalTransferSyntax.IsEncapsulated为 false，否则解码失败静默返回空图
真正麻烦的从来不是读出像素，而是搞清每个 tag 在当前设备上的实际语义。同一台 GE 设备不同固件版本，PhotometricInterpretation 的写法都可能不一致——得靠实测样本反推，不能只信文档。
