📚 课程目录第4章 MaxQuant安装与配置

4. MaxQuant 安装与配置：安装步骤、环境变量设置、隐藏参数配置文件 mqpar.xml 的结构解读

这一章咱们实实在在地把 MaxQuant 装到机器上，再把配置文件扒开看看。别看安装只是双击下一步，配置里藏着不少坑。我个人习惯是先理解文件结构再动手，这样出了问题能快速定位。

4.1 安装准备与系统要求

先把环境捋清楚。MaxQuant 本质上是个 .NET 应用，对 Windows 依赖很深。

项目	要求	我的建议
操作系统	Windows 10/11 64位	别用Windows Server，有些绘图库会报错
.NET Framework	4.7.2 或更高	Win10自带4.8，Win11是4.8.1，基本不用手动装
Java Runtime	JRE 8 或 11	Andromeda引擎需要，装OpenJDK就行
内存	最低8GB，推荐32GB+	处理多批次时，我建议至少64GB
硬盘	SSD，剩余空间≥200GB	临时文件很大，别放C盘

注意：不推荐在虚拟机里跑MaxQuant，尤其是多批次联合分析。文件I/O和内存都容易出问题。我曾经在VMWare上跑过一批，结果写入速度只有物理机的三分之一。

4.2 安装步骤详解

安装其实就三步，但细节决定成败。嗯，这里要注意版本的选择。

第一步：下载正确的安装包

去 MaxQuant 官网下载。别随便在百度云上找，曾经有人下到带捆绑软件的版本。下载时注意两点：

稳定版 vs 开发版：做生产数据，老老实实用稳定版。
32位 vs 64位：现在几乎没有32位系统了，直接选64位。

第二步：执行安装程序

双击运行。安装路径不要有中文、空格和特殊字符。

推荐的安装路径：
D:\MaxQuant\MaxQuant_2.4.2.0\
不推荐的安装路径：
C:\Program Files\MaxQuant\ （权限问题）
D:\软件\MaxQuant\ （中文字符）

为什么推荐 D 盘？因为C盘通常是系统盘，MaxQuant运行时会产生大量临时文件，多个批次同时写入会给C盘压力。

第三步：验证安装

安装完成后，找到安装目录下的 MaxQuant.exe，双击启动。

检验方法：
1. 启动后看左下角版本号，与下载版本一致
2. 随便拖入一个raw文件，不报错
3. 关闭，再通过命令行启动：
D:\MaxQuant\MaxQuant_2.4.2.0\MaxQuant.exe

  提示：如果能从命令行启动，说明环境变量基本没问题。这是后面多批次自动化调度的基础。

4.3 环境变量设置

环境变量这东西，很多人嫌麻烦不设置。但做多批次运行，环境变量能省掉很多手动操作的麻烦。

设置 MAXQUANT_HOME

我个人习惯用这个变量来标识MaxQuant的根目录，脚本里引用起来特别方便。

新增系统变量：
变量名: MAXQUANT_HOME
变量值: D:\MaxQuant\MaxQuant_2.4.2.0

设置 Java 路径

Andromeda 搜索引擎依赖 Java，MaxQuant 默认会在 PATH 里找 java.exe。如果你装过多个 Java 版本，系统可能找到错的。

在 Path 变量中添加：
%MAXQUANT_HOME%\java\bin\
或者指定完整的：
C:\Program Files\Java\jre1.8.0_321\bin\

TEMP 目录的调整

这个容易被忽略。MaxQuant 在处理大量 spectrum 时会写临时文件，默认在 C:\Users\用户名\AppData\Local\Temp。一旦SSD空间不够，整个分析直接崩。

我建议的做法：
1. 在 D 盘新建文件夹 D:\Temp
2. 设置系统变量：
   变量名: TMP
   变量值: D:\Temp
   变量名: TEMP
   变量值: D:\Temp
3. 重启系统使生效

验证TEMP路径是否生效：
打开cmd，输入 echo %TEMP%
输出应该是 D:\Temp

注意：修改 TEMP 环境变量后，某些依赖 %TEMP% 的软件可能短暂报错。建议在分析窗口开始前设置，分析结束后恢复。我专门写过一个批处理脚本来做切换。

4.4 揭开 mqpar.xml 的面纱

这是 MaxQuant 的核心配置文件。很多用户只会在 GUI 界面上点来点去，从来不知道 mqpar.xml 里藏着什么。说白了，GUI 上的每一个参数，最终都会被序列化成这个 XML 文件。

文件在哪里？

当你新建或打开一个参数设置，MaxQuant 会在工作目录下生成 mqpar.xml。

我的习惯是：
D:\Projects\Batch001\mqpar.xml
D:\Projects\Batch002\mqpar.xml
每个批次独立一个文件夹，避免配置文件覆盖

整体结构概览

一个典型的 mqpar.xml 长得像这样：

<?xml version="1.0" encoding="utf-8"?>
<MaxQuantParams xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <filepaths>
    <string>D:\RawData\Sample01.raw</string>
    <string>D:\RawData\Sample02.raw</string>
  </filepaths>
  <parameterGroups>
     ...
  </parameterGroups>
</MaxQuantParams>

关键节点解读

XML节点路径	对应GUI选项	多批次中要注意的坑
`filepaths`	原始文件列表	路径用绝对路径，别用相对路径，否则会报"文件未找到"
`parameterGroups/…/fixedModifications`	固定修饰	不同批次的修饰要一致，否则比对困难
`parameterGroups/…/variableModifications`	可变修饰	氧化(M)千万别漏，不然定量结果会偏低
`parameterGroups/…/enzymeName`	酶切类型	Trypsin/P 和 Trypsin 差别很大，检查数据来源
`parameterGroups/…/maxMissedCleavages`	最大漏切数	多批次我通常统一设为2
`threads`	线程数	设置太高会拉满CPU服务器上其他作业会卡

一个避坑点：你手动改完 mqpar.xml 后，如果再用 GUI 打开并保存，某些节点会被GUI重写。比如 filepaths 的顺序可能会变。我一般用脚本批量生成 mqpar.xml，然后指定给 MaxQuantCmd.exe 直接启动，全程不经过 GUI。

技巧： 准备一个"模板" mqpar.xml，把修饰、酶切、搜索参数都配好，保留 filepaths 节点为空。每次新建批次时，用 Python 或 PowerShell 脚本把原始文件列表写进去。

4.5 隐藏参数：GUI 不显示的那些配置

有些参数 GUI 里看不到，但 mqpar.xml 支持。我刚开始也不知道，后来遇到一个批次总是搜不到某些肽段，翻文档才发现这些隐藏参数。

常见隐藏参数一览

<!-- 在 <MaxQuantParams> 下直接添加 -->

<!-- 肽段鉴定FDR阈值，默认0.01，可改为0.05提高灵敏度 -->
<peptideFDR>0.01</peptideFDR>

<!-- 蛋白质鉴定FDR阈值，建议保持默认0.01 -->
<proteinFDR>0.01</proteinFDR>

<!-- 用于匹配的质谱类型： 0=MS1, 1=MS2, 2=MS1+MS2 -->
<matchingType>2</matchingType>

<!-- 是否使用match between runs： 1=开启, 0=关闭 -->
<matchBetweenRuns>1</matchBetweenRuns>

<!-- 匹配的时间窗口（秒），默认60秒 -->
<matchTimeWindow>60</matchTimeWindow>

<!-- 匹配的m/z窗口（ppm），默认20ppm -->
<matchMzWindow>20</matchMzWindow>

为什么要手动加这些？

GUI上很多设置在“高级选项”或者隐藏起来了。多批次运行时，每个批次的参数必须严格一致，手动改 XML 比在 GUI 上逐个点要精准得多。我曾经因为两个批次的 matchBetweenRuns 设置不一致，导致最终合并时定量结果出现系统偏差。

4.6 一张图看清配置流程

下面这张 SVG 图把安装、环境变量、配置文件的逻辑串起来了。你看，每一步都有它的位置，跳过任何一个环节都可能导致运行失败。

<svg viewBox="0 0 800 500" style="max-width:100%;height:auto;display:block;margin:1.5rem auto;" xmlns="http://www.w3.org/2000/svg">
  <rect x="0" y="0" width="800" height="500" fill="#f0f8ff" rx="8"/>
  <text x="400" y="40" text-anchor="middle" font-size="20" font-weight="bold" fill="#2c3e50">MaxQuant 配置全流程框架</text>

  <!-- 第一步：安装 -->
  <rect x="60" y="70" width="200" height="70" rx="10" fill="#3498db" stroke="#2980b9" stroke-width="2"/>
  <text x="160" y="100" text-anchor="middle" font-size="15" fill="#ffffff" font-weight="bold">第一步：安装</text>
  <text x="160" y="122" text-anchor="middle" font-size="12" fill="#ffffff">下载安装包 → 双击安装</text>

  <!-- 第二步：环境变量 -->
  <rect x="300" y="70" width="200" height="70" rx="10" fill="#2ecc71" stroke="#27ae60" stroke-width="2"/>
  <text x="400" y="100" text-anchor="middle" font-size="15" fill="#ffffff" font-weight="bold">第二步：环境变量</text>
  <text x="400" y="122" text-anchor="middle" font-size="12" fill="#ffffff">MAXQUANT_HOME / JAVA</text>

  <!-- 第三步：mqpar.xml -->
  <rect x="540" y="70" width="200" height="70" rx="10" fill="#e74c3c" stroke="#c0392b" stroke-width="2"/>
  <text x="640" y="100" text-anchor="middle" font-size="15" fill="#ffffff" font-weight="bold">第三步：配置文件</text>
  <text x="640" y="122" text-anchor="middle" font-size="12" fill="#ffffff">解析 mqpar.xml</text>

  <!-- 箭头：第一步 → 第二步 -->
  <line x1="260" y1="105" x2="295" y2="105" stroke="#7f8c8d" stroke-width="3" marker-end="url(#arrow)"/>
  <!-- 箭头：第二步 → 第三步 -->
  <line x1="500" y1="105" x2="535" y2="105" stroke="#7f8c8d" stroke-width="3" marker-end="url(#arrow)"/>

  <!-- 三个子步骤：隐藏参数 & 路径 & 验证 -->
  <rect x="60" y="190" width="160" height="50" rx="8" fill="#9b59b6" stroke="#8e44ad" stroke-width="2"/>
  <text x="140" y="210" text-anchor="middle" font-size="13" fill="#ffffff">设置 TEMP 路径</text>
  <text x="140" y="228" text-anchor="middle" font-size="11" fill="#ffffff">避免C盘撑爆</text>

  <rect x="250" y="190" width="160" height="50" rx="8" fill="#f39c12" stroke="#e67e22" stroke-width="2"/>
  <text x="330" y="210" text-anchor="middle" font-size="13" fill="#ffffff">验证安装</text>
  <text x="330" y="228" text-anchor="middle" font-size="11" fill="#ffffff">命令启动正常</text>

  <rect x="440" y="190" width="160" height="50" rx="8" fill="#1abc9c" stroke="#16a085" stroke-width="2"/>
  <text x="520" y="210" text-anchor="middle" font-size="13" fill="#ffffff">隐藏参数补齐</text>
  <text x="520" y="228" text-anchor="middle" font-size="11" fill="#ffffff">FDR / 匹配窗口</text>

  <!-- 虚线箭头：横线 → 子步骤 -->
  <line x1="160" y1="140" x2="140" y2="185" stroke="#7f8c8d" stroke-width="2" stroke-dasharray="5,5" marker-end="url(#arrow)"/>
  <line x1="400" y1="140" x2="330" y2="185" stroke="#7f8c8d" stroke-width="2" stroke-dasharray="5,5" marker-end="url(#arrow)"/>
  <line x1="640" y1="140" x2="520" y2="185" stroke="#7f8c8d" stroke-width="2" stroke-dasharray="5,5" marker-end="url(#arrow)"/>

  <!-- 说明框 -->
  <rect x="100" y="290" width="600" height="50" rx="8" fill="#fff3cd" stroke="#ffc107" stroke-width="2"/>
  <text x="400" y="312" text-anchor="middle" font-size="13" fill="#856404">多批次运行前，这三步必须全部完成并验证通过</text>
  <text x="400" y="330" text-anchor="middle" font-size="12" fill="#856404">建议写一个 setup.bat 自动完成环境变量和文件检查</text>

  <!-- 最终产出 -->
  <rect x="250" y="380" width="300" height="60" rx="30" fill="#e74c3c" stroke="#c0392b" stroke-width="2"/>
  <text x="400" y="408" text-anchor="middle" font-size="16" fill="#ffffff" font-weight="bold">产出：稳定的运行环境</text>
  <text x="400" y="428" text-anchor="middle" font-size="13" fill="#ffffff">+ 标准化的配置文件</text>

  <line x1="400" y1="340" x2="400" y2="375" stroke="#7f8c8d" stroke-width="3" marker-end="url(#arrow)"/>

  <defs>
    <marker id="arrow" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="8" markerHeight="8" orient="auto">
      <path d="M 0 0 L 10 5 L 0 10 Z" fill="#7f8c8d"/>
    </marker>
  </defs>
</svg>

4.7 小结与自查清单

配置到位了，后续的多批次运行才能顺畅。我列了一个小清单，每次配置完新环境后，对着打勾：

[] 安装路径无中文、无空格，版本正确
[] MAXQUANT_HOME 环境变量已设置并生效
[] Java 路径已配置，命令行运行 java -version 正常
[] TEMP 路径已改到非系统盘
[] mqpar.xml 模板已准备，隐藏参数已手动补齐
[] 至少用一个小数据集跑过端到端验证，无报错