2. 输入文件格式问题：RAW文件读取错误、光谱文件损坏、格式不支持
大家好，欢迎来到第二章。
这次我们聊聊最基础、也最让人头疼的问题 —— 输入文件格式。你想想看，写了半天参数，点完“Run”，结果软件弹个错，告诉你文件读不了。是不是很崩溃？
我在项目中碰到过很多新手，第一步就卡在这里。其实大部分文件读取问题，都是有规律可循的。我们今天就把这些坑一个个填平。
2.1 RAW文件读取失败：最常见，但别慌
RAW文件是质谱仪器的原始数据。MaxQuant 主要支持 Thermo Fisher 的 .raw 格式。别的仪器厂商的格式，比如 .wiff（Sciex）、.d（Bruker），需要先转成 .mzXML 或 .mgf 才能用。这个后面会讲。
为什么读不了？
- 版本兼容性：Thermo RAW 文件有版本号。MaxQuant 依赖底层库（MSFileReader）来解析。如果你的 RAW 文件是用最新版 Xcalibur 采集的，但 MaxQuant 内置的 MSFileReader 版本太老，就读不了。
- 文件损坏：传输中断、硬盘坏道、拷贝时出错，都可能导致 RAW 文件结构损坏。
- 权限问题：这个容易被忽略。文件放在系统保护目录或只读卷上，MaxQuant 打不开。
- 路径问题：我见过有人把文件名写成中文，或者路径里有空格和特殊符号。虽然 MaxQuant 这些年有改进，但我个人习惯还是坚持全英文路径，最省心。
我的诊断习惯
遇到 RAW 文件报错，我通常会先看一眼 MaxQuant 的 mqpar.xml 里的文件路径。拷贝出来，在 Windows 资源管理器里直接粘贴回车，看能不能打开。如果系统提示文件损坏，那就是文件本身的问题了。
错误日志长什么样？
Error: Could not read file C:\Data\sample01.raw.
Failed to open RAW file. The file may be corrupt or in an unsupported format.
at ThermoFisher.CommonCore.Data.Business.RawFile..ctor(String path)这段日志的核心信息是最后一行，它告诉你是在底层 RAW 文件读取器里报的错。
2.2 光谱文件损坏与格式不支持
除了 RAW，MaxQuant 也能吃一些通用格式，比如 .mzXML、.mzML、.mgf。但这些格式也有自己的坑。
2.2.1 mzXML / mzML 文件
这些是开放标准格式，用文本或压缩方式存储。损坏通常表现为：
- XML 结构不完整（少了一个闭合标签）。
- 索引区（index）和实际数据区不一致。
- 压缩方式用了 MaxQuant 不支持的算法。
2.2.2 MGF 文件
Mascot Generic Format，文本格式，比较脆弱。我遇到过最常见的问题是：
- 谱图标题里有非法字符（比如换行符）。
- 峰列表格式不对（比如缺了
END IONS）。 - 电荷状态写错（比如
CHARGE=2+ and 3+，MaxQuant 有时不认这种混合表述）。
特别提醒
千万不要拿记事本去手动编辑 MGF 文件。你保存时，记事本可能会给文件末尾加上 UTF-8 BOM 头，或者把换行符改成 Windows 风格。这些改动都可能让 MaxQuant 解析报错。
2.3 怎么排查？一步一步来
我曾经带过一个学生，他对着一个报错日志盯了半小时。其实没必要。我整理了一个排查流程，你可以照着走一遍。
- 先看日志文件：在 MaxQuant 的输出目录里找到
mqpar.xml或log.txt。搜索 "Error" 或 "Exception"。 - 检查文件大小：一个空白的 RAW 文件大小通常只有几百 KB。正常实验文件至少几十 MB。右键看属性，如果文件大小异常小，基本可以断定是传输中断或写入失败。
- 用官方工具验证：Thermo 的 RawFileReader 工具可以单独打开 RAW 文件。如果它打不开，那 MaxQuant 肯定也打不开。
- 重新转换：对于 .raw 文件，试试用 MSConvert（ProteoWizard 的一部分）重新转换一遍，不转格式，只做一次“重写”。有时能修复一些轻微的索引错位。
- 改名移路：把文件名改成纯英文，去掉所有空格和特殊符号，放在磁盘根目录下一个简短的路径里，比如
D:\raw\sample1.raw。
一句话总结
文件报错，90% 是文件本身坏了或路径不对。剩下的 10% 是版本和格式坑。按照上面的流程走一遍，基本都能定位到原因。
2.4 不同仪器厂商的格式支持情况
我整理了一张表，供你快速对照。实际项目里，你大概率只会用到一种或两种，但了解全貌总是好的。
| 仪器厂商 | 原生格式 | MaxQuant 直接支持？ | 推荐转换方式 |
|---|---|---|---|
| Thermo Fisher | .raw | 是 | 无需转换，直接用 |
| Bruker | .d (文件夹) | 部分支持（需特定版本） | MSConvert 转 .mzML |
| Sciex (AB Sciex) | .wiff / .wiff.scan | 否 | PeakView 导出 .mgf 或 MSConvert 转 .mzML |
| Agilent | .d (文件夹) | 否 | MSConvert 转 .mzML |
| Waters | .raw (文件夹) | 否 | ProteinLynx Global SERVER 导出或 MSConvert |
2.5 格式问题背后的逻辑
说白了，MaxQuant 的核心用的是 Thermo 的专有库。对其他厂商的格式支持，是后来通过 ProteoWizard 这些开源工具桥接进去的。所以，如果桥接层出了问题，就会报格式不支持。
这张图帮你理清了思路。不管报什么错，最终都汇到一条主线上：找到文件本身的问题，或者找到转换链条上的问题。
2.6 一个真实案例
我记得有一次，用户发来一个 .raw 文件，说 MaxQuant 一读就崩溃。我看了一下日志，里面写着 Invalid parameter。这就很模糊了。
我用 RawFileReader 打开，也是报错。再查看文件属性，发现文件大小只有 1.2 MB，而正常实验文件应该是 800 MB 左右。我跟用户确认后才知道，他在服务器上采完数据，用 FTP 下载到本地时，由于网络不稳定，文件只传输了一小部分就断了。
重新传输完整文件后，MaxQuant 运行正常。你看，很多时候问题就这么简单，关键在于知道从哪入手去查。