📚 课程目录第3章 AutoDock软件安装与环境配置

3. AutoDock 软件安装与环境配置归纳总结

说白了，搞分子对接的第一步就是把家伙事儿备齐。我记得早年刚入行那会儿，光装个软件就折腾了三天，不是缺库就是路径不对。现在虽然省心多了，但坑还是有的。

本章我就把自己这些年踩过的坑、走过的弯路，给你掰开了揉碎了讲清楚。环境配好了，后面才跑得顺。

3.1 安装前的准备工作

别急着装软件。先看看你手头的系统环境。我个人习惯用一个表来对照，一目了然：

操作系统	推荐版本	需要提前装好的东西
Windows	10/11 (64位)	无特殊要求，管理员权限
Linux	Ubuntu 20.04/22.04	gcc, g++, make, cmake
macOS	Big Sur 及以上	Xcode Command Line Tools

小提示： Linux用户最好把 build-essential 装全。我遇到过几次编译到一半报错，查了半天发现是缺了libc-dev。

3.2 Windows 下的安装

Windows其实最简单。官方给的是编译好的二进制包，你直接下载就行。

具体步骤：

去 MGLTools 官网下载 Windows 版安装包
双击运行，一路默认路径就行
安装完成后会在桌面生成 AutoDock Tools 图标

但这里有个坑——路径不能有中文。我曾经帮一个学生排查问题，花了半小时才发现他装在了“D:\软件\AutoDock”下，结果程序死活打不开。

警告：安装路径切勿包含中文、空格或特殊字符。建议统一用英文路径，比如 D:\AutoDock\。

装完之后，你需要在系统环境变量里加上 AutoDock4 和 AutoGrid4 的路径。

操作路径：此电脑 -> 属性 -> 高级系统设置 -> 环境变量 -> Path -> 新建
添加以下路径（假设你装在D盘）：
D:\AutoDock\AutoDock4
D:\AutoDock\AutoGrid4

验证一下。打开 CMD 窗口，输入：

autodock4.exe --help

如果你能看到一堆参数说明，那就成了。

3.3 Linux 下的安装

Linux 用户我建议编译安装。虽然官网也能下二进制包，但自己编译的过程能让你更清楚软件的结构。出了问题也好排查。

先准备好依赖环境：

sudo apt update
sudo apt install build-essential cmake libc6-dev

然后下载源码包。以 AutoDock 4.2.6 为例：

wget https://ccsb.scripps.edu/autodock/files/autodock-4.2.6.tar.gz
tar -xzf autodock-4.2.6.tar.gz
cd autodock-4.2.6

编译过程其实不复杂：

./configure
make
sudo make install

不过，你想想看，这里有个细节——默认安装路径是 /usr/local。如果你没有 root 权限，那就得手动指定安装目录：

./configure --prefix=$HOME/autodock
make
make install

    我的习惯：编译完成后，把 $HOME/autodock/bin 加到 ~/.bashrc 的 PATH 里。这样每次打开终端就能直接用。

安装完成后，验证一下：

autodock4 --version

如果提示命令没找到，八成是环境变量没加对。检查一下 ~/.bashrc 吧。

3.4 macOS 下的安装

macOS 的安装思路跟 Linux 类似，但要先装好 Xcode Command Line Tools。

xcode-select --install

然后一样的流程，下载源码编译。不过 macOS 上的编译器跟 Linux 略有区别，我遇到过几次因为 clang 版本太低导致编译失败的情况。

这时候你换个编译器试试：

export CC=/usr/local/bin/gcc-11
export CXX=/usr/local/bin/g++-11
./configure
make
sudo make install

注意：macOS 的 M1/M2 芯片用的是 arm64 架构，默认编译可能会出问题。我建议用 Rosetta 2 转译 x86 版本，或者在 configure 的时候加上 --host=arm64 参数。

3.5 环境配置的核心要点

环境配置其实就三件事：路径、权限、依赖。我整理了一张表，你对着检查就行：

检查项	命令行	正常结果
AutoDock 是否可用	`which autodock4`	显示路径，如 /usr/local/bin/autodock4
AutoGrid 是否可用	`which autogrid4`	显示路径
Python 环境	`python --version`	显示版本号，建议 3.8 以上
MGLTools 可用	`pythonsh -c "import Pmw"`	无报错

我曾经帮人排查一个很诡异的问题：AutoDock 能运行，但计算结果全是 0。最后发现是 autogrid4 没装成，网格文件一直没生成。所以两个东西都要测一遍。

3.6 验证安装是否成功

装完了总得试试真功夫。我习惯用一个简单的小分子跑一遍测试。

下载官方给的测试例：

# Linux/macOS
wget https://ccsb.scripps.edu/autodock/test/autodock_test.tar.gz
tar -xzf autodock_test.tar.gz
cd autodock_test

# 准备配体、受体和网格参数
prepare_ligand4.py -l ligand.pdb
prepare_receptor4.py -r receptor.pdb
prepare_gpf4.py -r receptor.pdb -l ligand.pdb
prepare_dpf4.py -r receptor.pdb -l ligand.pdb

# 跑网格计算
autogrid4 -p receptor.gpf -l glg.log

# 跑对接计算
autodock4 -p ligand.dpf -l dlg.log

如果最后能看到 dlg.log 文件生成，并且里面有对接打分信息，那就说明环境配得没问题了。

避坑指南：测试例里的小分子是固定的。我第一次跑的时候用的是自己的分子，结果原子类型对不上，报了一堆错。建议新人先跑官方测试例，跑通了再换自己的。

3.7 常见问题与解决方案

嗯，说几个我遇到比较多的问题：

./configure 报错"no acceptable C compiler" —— 说白了就是没装gcc。Ubuntu用户 sudo apt install build-essential，macOS用户重装Xcode Command Line Tools。
autodock4: command not found —— PATH没配对。检查一下你的 ~/.bashrc 或者系统环境变量。
编译时报错"cannot find -lX11" —— 缺X11库。Linux用户装 libx11-dev，macOS用户装 XQuartz。
Python脚本报错"ImportError: No module named Pmw" —— MGLTools的Python路径没设对。确保用的是MGLTools自带的Python解释器（pythonsh），而不是系统自带的。

终极建议：如果实在搞不定，干脆用Docker。我写了一个镜像，一键拉取就能用，省去所有环境配置的烦恼。拉取命令：

docker pull biocontainers/autodock4

环境配置这件事，说白了就是要把工具链理顺。理顺了，后面跑对接的时候就能专心分析结果，不用老担心是不是软件出了BUG。