本文详解 nrrd 文件中多文件切片（multi-slice）体积加载失败的典型原因——data file: 字段语法不合规，并提供符合 nrrd 规范的正确写法、验证方法及实践注意事项。
本文详解 nrrd 文件中多文件切片（multi-slice）体积加载失败的典型原因——data file: 字段语法不合规，并提供符合 nrrd 规范的正确写法、验证方法及实践注意事项。
在使用 NRRD 格式存储三维医学影像（如 CT 或 MRI 序列）时，常见做法是将每张二维切片保存为独立的原始二进制文件（如 I0023679.M01, I0023679.M02…），再通过主 NRRD 头文件统一描述其空间结构与数据组织方式。当单切片可正常加载而多切片体积构建失败时，问题往往并非出在图像数据本身，而是 NRRD 头文件中 data file: 字段的格式违反了官方规范。
根据 NRRD 官方格式文档（v4），当使用多个分离的数据文件（detached data files）表示一个 volume 时，data file: 字段必须显式声明为 LIST 关键字，且该关键字需独占一行，后接所有切片文件路径（每行一个），且该字段必须位于头文件末尾（即其后不可再有其他字段）。原始配置中直接写成：
data file: I0023679.M01 I0023679.M02 ...
是非法的：它被解析为单个文件名（含空格和换行），而非文件列表，导致读取器（如 ITK、pynrrd、3D Slicer）无法识别多文件结构，从而静默失败或报错“invalid data file specification”。
✅ 正确写法如下（严格遵循规范）：
# ... 其他头部字段保持不变（dimension, sizes, space directions 等） byte skip: 1609 data file: LIST I0023679.M01 I0023679.M02 I0023679.M03 I0023679.M04 I0023679.M05 I0023679.M06 I0023679.M07 I0023679.M08 I0023679.M09
⚠️ 关键注意事项：
- LIST 必须原样书写，全大写，无引号、无空格、无前缀；
- data file: LIST 行之后不得再出现任何其他 NRRD 字段（如 encoding: 或注释 # ...），否则解析器会将其误认为文件名；
- 所有切片文件路径需相对于 NRRD 文件所在目录（或使用绝对路径），且确保文件存在、权限可读；
- 若某切片文件名恰好为 LIST，应改用 ./LIST 或 LIST.bin 等方式规避关键字冲突；
- 建议使用 pynrrd 进行快速验证：
import nrrd data, header = nrrd.read('volume.nrrd') # 成功则 data.shape == (272, 272, 9) print(data.shape, header.get('sizes'))
总结：NRRD 多切片体积加载失败，90% 源于 data file: 字段未按规范使用 LIST 显式声明。修正后不仅可被主流医学图像库（ITK/ITK-Python、VTK、3D Slicer）正确加载，还能确保跨平台一致性与长期可读性。务必以 NRRD v4 规范为唯一依据，避免依赖特定读取器的非标容错行为。
