HDF5 / H5 / NXS 科学数据查看器打不开或显示异常？排错指南
按文件签名、版本、单位、坐标和浏览器资源顺序排查HDF5 / H5 / NXS 科学数据查看器，并保留原始文件。
不要先改后缀或覆盖原文件
复制一个样本用于排错，保留原始交付文件、文件大小、生成软件版本和错误提示。打开一份 NeXus 文件后，沿 /entry/data 找到二维计数矩阵，查看 shape=[1024,2048]、dtype 和 units 属性，只读取 [0:100,0:100] 热图。不要为预览一次读取整个数 GB 数组。
推荐排查顺序
- 用工具页面的示例或一份更小的同类文件确认浏览器功能正常。
- 检查文件签名与扩展名是否一致，确认文件没有被下载为 HTML 错误页。
- 对照工具支持格式、大小上限和下面的专业检查项。
- 关闭其他大型标签页，在最新版 Chrome 或 Edge 重试。
- 仍异常时回到创建该文件的软件重新导出，并在正式专业软件中复核。
针对这个格式的检查
- 根 Group 和预期 Dataset 路径存在
- shape、dtype、endianness 与生成程序约定一致
- chunks、compression 和 fill value 可读
- 切片起止和维度没有越界，导出 CSV 只针对当前二维小切片
常见错误与解决方法
扩展名是 .nc 仍打不开
先用 file signature 判断是否 HDF5；经典 NetCDF3 不属于 HDF5，需要另一套解析器。
Dataset 可见但预览报错
可能使用自定义 filter、对象引用或复杂 compound dtype；保留原文件并在 HDFView/Python 中打开。
哪些情况不能靠网页工具
- 经典 NetCDF3 即使扩展名为 .nc 也不受支持
- 对象引用、自定义 filter 和部分复合类型可能无法预览
- 大数组只读取有限切片，不提供整库导出
网页“能显示”只证明当前解析器读到了部分结构，不证明工程、生产、科研、商务或临床结果合规。正式交付应保留源软件和接收方的验证记录。
隐私与安全
本工具在浏览器本地读取文件，不会为解析而上传到 FreeTool。排错截图、导出 CSV 和浏览器下载仍可能包含敏感信息；共享前请脱敏，并在共享设备上清理这些副本。