用 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的写法都可能不一致——得靠实测样本反推，不能只信文档。
