3. 第3章

讲真,MaxQuant 的安装不算难,但环境配不对,后续跑起来全是坑。我见过不少同学下载完一解压就开始跑,结果要么闪退,要么报一堆 DLL 缺失。嗯,这一章我把自己踩过的雷、总结出的要点都摊开来说。

MaxQuant 安装与环境配置流程 ① 系统预检(OS / .NET) ② 下载 MaxQuant 安装包 ③ 解压 → 全英文路径 ④ 验证 .NET Framework 版本 ⑤ 首次启动 → 配置线程 / 内存 💡 关键点:安装包自带 .NET 检测,但 Windows 系统组件缺失仍会导致闪退。 建议先装 Windows 更新 + Visual C++ Redistributable。

3.1 操作系统与硬件门槛

MaxQuant 只支持 Windows。你别想用 macOS 或者 Linux 直接跑——我试过 Wine,结果各种诡异报错,最后老老实实切回 Windows 虚拟机。官方要求至少 Windows 7 SP1 以上,但我个人建议上 Windows 10 或 11 专业版,因为 .NET 支持和内存管理更稳。

项目 最低要求 推荐配置
操作系统 Windows 7 SP1 (64-bit) Windows 10/11 专业版 (64-bit)
内存 16 GB 32 GB 及以上
CPU 4 核,2.5 GHz 8 核以上,3.0 GHz
硬盘 SSD,50 GB 空闲 NVMe SSD,200 GB 空闲
.NET Framework 4.7.2 4.8 或更高

为什么内存这么吃紧? 你想想看,MaxQuant 处理一个 raw 文件就要把谱图全部载入内存进行匹配,如果同时跑多文件,16 GB 很容易爆。我曾经在一个 24 GB 的机器上跑 6 个 fraction,结果半小时后直接 OutOfMemoryException。

3.2 安装步骤详解

步骤其实很直白,但每一步都有陷阱。

  1. 从官网下载最新版本(当前是 2.6.x)。注意不要用第三方打包版,我遇到过被植入广告的版本。
  2. 解压到纯英文路径。别带中文、空格、特殊符号。我习惯放在 C:\MaxQuant\ 下。
  3. 以管理员身份运行 MaxQuant.exe。首次启动会检查 .NET 环境,如果缺组件会弹出提示。
  4. 设置工作目录和临时目录。在 Edit → Preferences 里修改,尽量放在空余大的 SSD 分区。
  5. 配置线程数和内存上限。我是这么设的:线程数 = 物理核心数 - 1,内存 = 物理内存的 70%。

跑完上面几步,基本能正常启动了。但别高兴太早——很多问题出在后续的数据库配置环节。

3.3 .NET Framework 版本检查

MaxQuant 依赖 .NET Framework 4.7.2+。怎么确认你装没装?两种方法:

  • 注册表法:运行 regedit,定位到 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full,看 Release 键值。大于 461308 就代表 4.7.2 及以上。
  • 命令行法:打开 PowerShell,执行:
(Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full").Release

如果返回空或者小于 461308,那就去微软官网下载 .NET Framework 4.8 运行时安装。装完重启系统,务必重启。

警告:千万不要卸载系统自带的 .NET 组件。我曾经手贱优化“系统垃圾”,把 .NET 4.0 卸了,结果 MaxQuant 直接打不开,控制台报 Could not load file or assembly。最后只能重装系统才搞定。

3.4 常见错误与避坑指南

我把安装配置阶段最常遇到的三个问题列出来,你遇到可以直接对照。

错误现象 根本原因 解决方案
双击无反应 / 闪退 .NET 版本不足 / Visual C++ Redistributable 缺失 安装 .NET 4.8 + VC++ 2015-2022 Redistributable (x64)
“Could not find a part of the path” 路径含中文或过长 移动 MaxQuant 目录到英文根路径下
内存溢出崩溃 内存上限设得太高(接近总内存) 在 Preferences 里将内存限制改为总物理内存的 60%~70%

关于内存上限,多说一句。MaxQuant 默认会尝试使用所有可用内存,这反而容易触发 Windows 的页面文件交换。我个人习惯设成 20 GB(如果机器有 32 GB)。当然具体值取决于你的 raw 文件大小和实验设计,原则是留 4~6 GB 给操作系统和后台进程。

3.5 高性能计算环境的额外配置

如果你在服务器或者工作站上部署,有几个细节能明显提升速度。

  • 关闭 Windows 自动更新:跑任务时突然重启,那就前功尽弃了。我的做法是进组策略禁用更新,并且把 MaxQuant 进程优先级设为“高”。
  • 开启大页面模式 (Large Pages):对于 .NET 应用,开启后能减少 TLB miss。需要管理员权限执行:
# 以管理员身份运行
bcdedit /set increaseuserva 3072
# 然后重启

注意:这个值设太大反而会导致系统不稳定,我一般设 3072(约 3 GB),视总内存调整。

  • 使用 RAM 盘存放临时文件:如果你有 64 GB 以上内存,可以划出 8~16 GB 做虚拟盘(比如 ImDisk),然后把 MaxQuant 的 temporary directory 指向它。写入速度能快一个数量级。但切记任务结束后把结果复制回 SSD,RAM 盘一断电就没了。

一个实用小技巧:每次启动 MaxQuant 之前,可以跑一次 wmic memphysical get MaxCapacity 确认系统能识别全部内存。我遇到过 BIOS 里只认一半的情况,导致配了一个大参数后程序依然报内存不足。

3.6 验证安装是否成功

装完别急着跑大数据集,先拿一个很小的 raw 文件(比如 100 MB 以内)做一次快速测试。

  1. 打开 MaxQuant。
  2. 点击左上角“Raw files”按钮,选择那个小测试文件。
  3. 在“Group-specific parameters”里选择“Default”模板。
  4. 直接点“Start”跑。

如果 5 分钟内正常跑完,没有弹出错误对话框,并且在输出文件夹里生成了 combined\txt 目录,那就说明环境配置到位了。