MaxQuant 安装与配置：让你的分析环境一次跑通
好，咱们开始干正事。安装配置这一步，看着简单，但坑不少。我见过不少新手卡在这一步一整天，其实说白了就几个关键点。我自己刚用 MaxQuant 那会儿，也因为 Java 版本不对，折腾了大半个下午。咱们今天一次性把它理顺。
1. 系统要求：别让你的机器拖后腿
MaxQuant 是个吃内存的大户。特别是处理磷酸化富集或者 TMT 标记的样本，动辄 64GB 起步。我有个项目曾用 32GB 机器跑 8 个 TMT 通道的数据，结果 swap 分区开始疯狂读写，整个流程慢得像蜗牛。
先看看最低要求和推荐配置：
| 组件 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10 / Server 2016 | Windows 11 / Server 2022 |
| 内存 | 32 GB RAM | 64 GB 或更高 |
| CPU | 4 核 8 线程 | 16 核 32 线程或更高 |
| 硬盘 | 500 GB 机械硬盘 | 1 TB NVMe SSD |
| Java 环境 | Java 11 (64-bit) | Java 17 (64-bit) |
| .NET Framework | 4.7.2 或更高 | 4.8.1 |
注意：千万别用 32 位 Java。MaxQuant 会直接报 Java heap space 错误。我曾经帮人远程调试，发现他装了个 32 位的 JRE，换了 64 位后一切正常。
2. 安装步骤：解压即用，但别乱放
MaxQuant 的安装非常简单——下载压缩包，解压即可。没有安装向导，也没有 registry 注册。但这不代表可以随便扔个地方。
我个人的习惯是这么做的：
- 创建一个专用目录，比如
C:\Apps\MaxQuant。不要放桌面或下载文件夹。 - 下载最新稳定版。目前建议用 2.4.x 系列，不要追最新 beta 版做正式分析。
- 解压到专用目录。解压后你会看到
bin,conf,lib三个子文件夹。 - 检查关键文件：确保
bin\MaxQuantGui.exe存在。
目录结构大致长这样：
C:\Apps\MaxQuant\
├── bin/
│ ├── MaxQuantGui.exe
│ ├── MaxQuantCmd.exe
│ └── ...
├── conf/
│ ├── MaxQuantGui.vmoptions
│ └── MaxQuantCmd.vmoptions
├── lib/
│ ├── *.jar
│ └── ...
└── MaxQuant.exe (启动器，可选)小提示：我习惯把 conf 目录下的 vmoptions 文件备份一下，特别是调过 JVM 参数之后。更新版本时直接覆盖回去，省得重新调。
3. 环境变量配置：让系统找到 MaxQuant
这一步很多人会忽略，但配置好了能省很多事。说白了就是让命令行也能调用 MaxQuant 的可执行文件。
需要添加以下两个东西：
- PATH 变量：加入
C:\Apps\MaxQuant\bin路径。 - MAXQUANT_HOME：设置为
C:\Apps\MaxQuant。
具体操作（Windows 系统）：
- 按
Win + R，输入sysdm.cpl，回车。 - 切换到「高级」选项卡，点击「环境变量」。
- 在「系统变量」中点击「新建」。
- 变量名填
MAXQUANT_HOME，变量值填C:\Apps\MaxQuant。 - 找到
Path变量，编辑，添加%MAXQUANT_HOME%\bin。 - 一路确定保存。
配置完后，打开新的命令行窗口，验证一下：
C:\Users\prot_user> MaxQuantCmd --version
MaxQuant 2.4.0.0, build 2024-01-15如果看到版本号，说明配置成功了。
重点：MAXQUANT_HOME 这个变量有些内部脚本会用，比如我们后面要讲的自动化批处理脚本。不设的话也能跑，但会多很多手工路径。我建议一开始就配好。
4. Java 环境校验：最容易被忽视的环节
MaxQuant 底层依赖 Java。很多奇怪的问题——比如闪退、卡在「Loading database」——都和 Java 有关。
校验步骤很简单：
C:\Users\prot_user> java -version
java version "17.0.9" 2023-10-17 LTS
Java(TM) SE Runtime Environment (build 17.0.9+11-LTS-206)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.9+11-LTS-206, mixed mode)这里要确认三件事：
- 版本在 11 以上（推荐 17）。
- 显示的是 64-Bit。
- 不是 OpenJDK 的早期版本（有些 < 11 的 OpenJDK 和 MaxQuant 有不兼容问题）。
避坑指南：我曾经遇到一台服务器，装了 Oracle JDK 8 和 OpenJDK 11，环境变量乱指到 JDK 8，MaxQuant 直接报 Unsupported class file major version。排查了两个小时才发现是 Java 版本混了。建议只留一个 Java 版本，或者用「JAVA_HOME」变量精确控制。
5. 常见问题：我踩过的那些坑
下面这几个问题，我在几次不同项目里都遇到过，整理成表供你参考：
| 现象 | 最可能原因 | 解决方案 |
|---|---|---|
| 双击 MaxQuantGui.exe 没反应 | Java 环境未配置或版本不对 | 检查 java -version，确认是 64 位且版本 ≥ 11 |
| 报错 "Could not reserve enough space for object heap" | vmoptions 中最大内存设置超过可用物理内存 | 减少最大堆设置，或升级物理内存 |
| 导入 raw 文件后卡住不动 | raw 文件路径包含中文或特殊符号 | 将路径改为纯英文，确保没有空格 |
| 运行中途闪退，无错误日志 | 系统 .NET Framework 版本过低 | 安装 .NET Framework 4.8.1 并重启 |
| 命令行调用报 "not recognized" | 环境变量未生效 | 重新打开 cmd，或重新配置 PATH |
关于内存配置：如果你处理的样本量很大（比如 10 个以上的 TMT 通道），我建议调整 conf\MaxQuantGui.vmoptions 文件。里面有个 -Xmx 参数，默认是 32g。如果你的机器有 128GB 内存，可以改成 -Xmx96g，给系统留点余量。改完后记得保存，重启 MaxQuant。
6. 运行验证：来，跑个测试
最后一步，找个小的测试数据（MaxQuant 官方有提供 mini 测试集）快速验证一下。
C:\Users\prot_user> MaxQuantCmd -i C:\TestData\mini.raw -o C:\TestOutput\如果命令行开始打印进度信息，而且没有报错，说明安装完全没问题了。
嗯，到这里安装配置这块基本就讲清楚了。环境准备好之后，咱们才能真正开始玩参数调优——那才是 MaxQuant 最精彩的部分。