2. MaxQuant 安装与配置：系统要求、安装步骤、Java 环境配置、路径设置
说到 MaxQuant 的安装配置，我见过不少新手上手就卡在这步。说实话，只要把系统环境摸清楚，后面就顺了。这一节咱们把安装和配置掰开揉碎讲透，你照着来，基本不会出幺蛾子。
2.1 系统要求：先看看你的机器能不能跑
MaxQuant 是纯 Java 写的，按理说跨平台。但实际操作中，Windows 是最稳的。我在 Linux 和 macOS 上也折腾过，总有些小毛病。所以，我建议你首选 Windows 10/11 64 位。
下面是硬件和软件的底线要求，你拿自己机器对照一下：
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 7 SP1 64 位 | Windows 10/11 64 位 |
| 内存 | 8 GB | 32 GB 或以上 |
| CPU | 4 核 | 8 核以上，高频 |
| 硬盘 | 50 GB 可用空间 | 200 GB 以上 SSD |
| Java | JRE 8 或 JRE 11 | JRE 11（64 位） |
| .NET Framework | 4.5 | 4.7+ |
我遇过最头疼的情况：内存只有 8 GB，跑一个 10 个 fraction 的 label-free 项目，直接 OutOfMemoryError。后来加了条 16 GB 内存条，才消停。说白了，内存是瓶颈，千万别省。
2.2 安装步骤：下载、解压、目录结构
安装其实就三步：下载、解压、放在你习惯的位置。没有安装向导，解压即用。
- 下载：去 MaxQuant 官网（coxgroup）找最新版本。我通常下 stable 版，不追 dev 版，省得踩坑。
- 解压：把 zip 包解压到
C:\MaxQuant或D:\tools\MaxQuant。路径里不要有中文和空格！我曾经因为路径带了个“蛋白质组”汉字，搜库时直接报路径编码错误，折腾了一下午。 - 目录结构：解压后你会看到几个关键文件夹和程序。
正常的目录长这样：
C:\MaxQuant\
├── MaxQuant.exe
├── MaxQuantCmd.exe
├── lib\ # Java 依赖 jar 包
├── conf\ # 配置文件，不用动
├── logs\ # 运行日志，调试用
├── templates\ # 搜参模板
└── readme.txtMaxQuant.exe 是图形界面，MaxQuantCmd.exe 是命令行。日常调参我习惯用图形界面，批量跑时才用命令行。
2.3 Java 环境配置：装对版本，配好变量
MaxQuant 依赖 Java。很多人的问题就出在 Java 版本不对，或者没配环境变量。
2.3.1 确认 Java 版本
打开命令提示符，输入：
java -version输出类似：
java version "11.0.18" 2023-01-17 LTS
Java(TM) SE Runtime Environment 18.9 (build 11.0.18+9-LTS-195)
Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.18+9-LTS-195, mixed mode)必须看到 64-Bit，版本号是 1.8（即 Java 8）或 11。如果显示 32-Bit 或版本不符，就需要重装。
where java 看优先级。我习惯把需要的 Java 路径放在环境变量 PATH 的最前面，这样不会串版本。
2.3.2 安装 JRE 11（推荐）
去 Adoptium 或 Oracle 官网下载 Java 11 LTS 64 位安装包。安装时记住路径，比如 C:\Program Files\Java\jdk-11.0.18（JDK 里自带 JRE）。
然后配置环境变量：
- 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
- 在「系统变量」里新建
JAVA_HOME，值为你的 JDK 路径（不含\bin）。 - 编辑
Path变量，添加%JAVA_HOME%\bin - 确定，然后重启命令行，重新运行
java -version验证。
这是配置示例：
变量名：JAVA_HOME
变量值：C:\Program Files\Java\jdk-11.0.18
Path 中添加：
%JAVA_HOME%\bin2.3.3 常见错误处理
- 「java 不是内部或外部命令」 —— 八成是 Path 没配好。检查
%JAVA_HOME%\bin是否存在。 - MaxQuant 启动后闪退 —— 可能是 Java 版本不兼容。我用 JRE 8 遇到过几次，换成 JRE 11 就稳了。
- 内存不足警告 —— 可以手动增加 JVM 堆内存。MaxQuant 启动时读取
conf\maxquant.conf，你可以改里面的-Xmx参数。
我曾经接手一台服务器，32 GB 内存，跑 20 个搜库任务，每个只分到 2 GB，结果频繁 OOM。后来把 -Xmx 提到 8 GB，同时限制并行数，问题就解决了。
2.4 路径设置：工作目录、临时目录、输出目录
MaxQuant 的路径设置直接影响运行效率和结果管理。下面是我个人总结的最佳实践。
2.4.1 工作目录（Working Directory）
每次搜库前，MaxQuant 会让你选一个工作目录。这个目录用来存放 mqpar.xml（参数文件）和中间结果。我建议为每个项目单独建一个工作目录，比如：
D:\projects\2024-09-15_HeLa_label_free\work不要放在系统盘（C 盘），免得空间不够。我曾经图方便丢在桌面，跑一半 C 盘满了……你想想看，那得多崩溃。
2.4.2 临时目录（Temp Directory）
MaxQuant 在运行期间会生成大量临时文件，默认在 %TEMP%（系统临时文件夹）。如果系统盘空间小，可以改到其他盘。
设置方法：在 conf\maxquant.conf 中添加或修改：
# 自定义临时目录
-Djava.io.tmpdir=D:\MaxQuant\temp记得提前把 D:\MaxQuant\temp 创建好。我习惯定期清理这个文件夹，不然会积累几十 GB 的垃圾。
2.4.3 输出目录（Output Directory）
搜库结果默认放在工作目录下的 combined\txt 子文件夹。想改的话，可以在参数文件 mqpar.xml 里设置 parameterGroup\outputFolder。不过我个人不推荐改，保持默认最省心，因为很多下游分析工具默认也是读这个路径。
2.5 快速验证：启动一个测试任务
装好之后，跑个最简单的小测试，看能不能正常走通。
- 打开
MaxQuant.exe，界面正常弹出，无报错。 - 加载一个示例
mqpar.xml（在templates目录里有）。 - 点击 “Run”，观察日志窗口。如果出现
Starting search...并且不崩溃，就说明安装成功了。