2. MaxQuant 安装与环境配置

这一章咱们来搞定 MaxQuant 的安装和环境配置。说实话，装软件这事儿看着简单，但里面的坑还真不少。我见过不少人在这一步卡住，后来发现都是些小细节没注意。今天我把 Windows 和 Linux 两条路都走一遍，该避的坑我一个不落。

2.1 版本选择：用哪个最省心？

MaxQuant 的版本大致分三个系列：1.5.x、1.6.x 和 2.0.x。怎么选？我个人的经验是这样的——

版本系列	特点	适用场景	我的建议
1.5.x	非常稳定，但功能较老	维护旧项目，兼容老数据	除非项目锁定，否则别碰
1.6.x	最广泛使用，生态成熟	日常蛋白质组学分析	新手首选 1.6.17.0
2.0.x	新架构，支持新修饰类型	前沿研究，需要新功能	2.0.3.0 以上较稳

我建议新手直接用 1.6.17.0。这个版本我用了两年多，跑了上百个样本，极少出幺蛾子。你想想看，做数据分析最怕什么？不是结果不好，而是软件本身不稳定。1.6.17.0 在这方面口碑一直不错。

如果你需要用到一些新功能，比如 2.0 新增的修饰类型或改进的 FDR 算法，那就上 2.0.3.0 或更高。但我提醒一句：别追最新的小版本，等出了两个补丁后再更新。

2.2 依赖环境：先把地基打好

MaxQuant 是 .NET 应用，底层搜索引擎 Andromeda 是 C++ 写的。所以它的依赖分两块：运行时环境和辅助工具。

Windows 依赖清单

• .NET Framework 4.7.2 或更高 —— 这是硬性要求，没有它 MaxQuant 根本跑不起来
• Java Runtime Environment (JRE) 8+ —— 部分辅助脚本和工具链需要
• VC++ Redistributable 2015-2022 —— Andromeda 搜索引擎依赖它

我曾经历过一次.NET版本不对导致MaxQuant闪退的问题，折腾了一天才发现是Framework版本低了。从那以后，我装机第一件事就是检查.NET版本。

检查方法很简单，打开命令行跑一下：

reg query "HKLM\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\full" /v version

如果输出显示版本低于 4.7.2，去微软官网下载安装包补上。

Java 的检查更直接：

java -version

如果提示 "java 不是内部或外部命令"，说明没装 JRE 或者没配环境变量。去 Java 官网下载安装就行，记得勾选 "设置 JAVA_HOME"。

Linux 依赖清单

Linux 下跑 MaxQuant 本质上是通过 Mono 来承载 .NET 运行时。说实话，有点折腾，但配好了之后很稳。

• Mono (完整版 mono-complete) —— 替代 .NET Framework
• Java Runtime Environment (JRE) 8+ —— 和 Windows 一样
• libgdiplus —— Mono 的 GDI+ 实现，图形界面需要

安装 Mono 的命令：

sudo apt-get update
sudo apt-get install mono-complete

我记得第一次在 Ubuntu 18.04 上配 Mono，装完发现 MaxQuant 启动报错，说缺少 libgdiplus。后来查了一圈才知道，mono-complete 在某些版本里不包含它，得手动补上：

sudo apt-get install libgdiplus

2.3 Windows 安装步骤

Windows 下的安装其实就两步：下载解压，配置环境。但细节上有些讲究。

1. 检查依赖 —— 按上一节的方法确认 .NET 和 Java 到位
2. 下载 MaxQuant —— 从官方站点下载对应版本的 zip 包
3. 解压到目标目录 —— 我个人习惯放在 D:\Tools\MaxQuant\，避免 C 盘权限问题
4. 配置数据库路径 —— 启动前先把数据库文件放到指定目录（后面会详说）
5. 运行验证 —— 双击 MaxQuant.exe，能正常弹出主界面就算成功

这里有一个很多人忽略的点：解压路径不要带中文和空格。我以前踩过这个坑——路径里有中文，Andromeda 引擎加载数据库时报错，花了半天才定位到是编码问题。

推荐目录结构：

D:\Tools\
├── MaxQuant\              # 主程序目录
│   ├── MaxQuant.exe
│   ├── Andromeda\
│   ├── conf\
│   └── ...
├── MaxQuant_databases\    # 数据库目录（单独放，方便管理）
│   ├── target\
│   └── decoy\
└── MaxQuant_projects\     # 项目目录（每个项目一个子目录）
    ├── project_001\
    └── project_002\

2.4 Linux 安装步骤

Linux 下的安装比 Windows 多一层 Mono 的适配，但跑命令行模式完全没问题。

1. 安装 Mono 和 Java —— 按 2.2 节的步骤来
2. 下载 MaxQuant —— 同样从官方站点获取 zip 包
3. 解压并设置执行权限
4. 通过 Mono 启动验证

具体的命令序列：

# 下载 MaxQuant 1.6.17.0
wget https://.../MaxQuant_1.6.17.0.zip

# 解压到指定目录
unzip MaxQuant_1.6.17.0.zip -d /opt/MaxQuant_1.6.17.0

# 设置可执行权限
chmod +x /opt/MaxQuant_1.6.17.0/MaxQuant.exe
chmod +x /opt/MaxQuant_1.6.17.0/Andromeda/Andromeda.exe

# 通过 Mono 启动（命令行模式）
mono /opt/MaxQuant_1.6.17.0/MaxQuant.exe --version

2.5 数据目录结构

搞清楚 MaxQuant 的目录结构，对后续配置和排错很有帮助。我把它分成 程序目录 和 工作目录 两块。

程序目录结构

MaxQuant_1.6.17.0/
├── MaxQuant.exe              # 主程序入口
├── Andromeda/                # 搜索引擎核心
│   ├── Andromeda.exe
│   └── Andromeda.config
├── conf/                     # 参数模板和配置文件
│   ├── mqpar.xml             # 默认参数模板
│   └── modification.xml      # 修饰类型定义
├── lib/                      # 运行时库
├── plugins/                  # 插件目录（2.0+ 版本支持）
└── README.txt

工作目录结构（推荐）

project_root/
├── raw/                      # 原始质谱数据文件（.raw）
├── fasta/                    # 数据库文件（.fasta）
│   ├── target/
│   └── decoy/
├── combined/                 # MaxQuant 输出结果
│   ├── txt/                  # 文本格式结果
│   ├── html/                 # HTML 报告
│   └── pdf/                  # PDF 汇总
└── mqpar.xml                 # 当前项目的参数文件

我个人习惯把数据库单独放在一个目录，不放在 MaxQuant 程序目录下。这样换版本时不用重新配置数据库路径，而且多个项目可以共享同一个数据库文件。

目录/文件	作用	注意事项
raw/	存放原始质谱数据	不要放在有中文的路径下
fasta/	存放蛋白质序列数据库	区分 target 和 decoy
combined/txt/	关键结果输出	蛋白质组、肽段、修饰等表格
mqpar.xml	实验参数配置文件	建议每个项目单独一份

2.6 验证安装

装完之后怎么确认一切正常？我的做法是跑一个快速验证流程。

Windows 下：

双击 MaxQuant.exe，如果能正常弹出主界面，并且 Help → About 里显示的版本号与你下载的一致，基本就稳了。

Linux 下：

跑一下命令行模式，检查版本和帮助信息：

mono /opt/MaxQuant_1.6.17.0/MaxQuant.exe --help
mono /opt/MaxQuant_1.6.17.0/MaxQuant.exe --version

如果能看到完整的帮助信息和版本号，说明 Mono 环境和 MaxQuant 本体都正常。

更进一步，你可以用一个小型测试数据跑一遍完整流程。我在项目中常用一个只有 3 个 RAW 文件的测试集，跑完检查 combined/txt/ 下是否生成了 proteinGroups.txt 和 peptides.txt。只要这两个文件出来了，安装配置就算彻底搞定。