第一章：Vina简介与安装

各位同学，欢迎来到《Vina参数筛选影响分析》的第一章。

我是你们这门课的主讲。咱们开门见山，今天要搞定两件事：第一，搞清楚Vina到底是个什么东西；第二，在你的电脑上把它跑起来。别小看安装，我见过太多人在这一步卡壳，后面全白搭。

1.1 Vina是什么？

AutoDock Vina，简称Vina，是一个做分子对接的软件。说白了，就是把一个小分子（配体）往一个蛋白大分子（受体）的洞里塞，看看能不能塞进去，塞进去之后结合得紧不紧。

你想想看，新药研发里，我们要找能跟靶点蛋白结合的候选分子。一个一个实验试，费钱又费时。Vina能帮我们在计算机里先筛一遍，把那些压根儿不结合的直接pass掉。我个人习惯把它叫做“硅基筛选器”，效率非常高。

Vina的计算核心是打分函数和全局搜索算法。它会模拟出配体在受体结合位点附近的无数种姿态，然后给每种姿态打一个分数，分数越低，说明结合得越稳定。

1.2 发展历史概览

这个故事要从2009年说起。我记得当时Scripps研究所的Oleg Trott博士放出了Vina的第一个版本。它一出现，大家就发现这东西快得离谱，比当时的AutoDock 4快了不知道多少倍，而且精度还更好。

我整理了一个简单的版本时间线，你看看：

版本	发布年份	主要改进点
Vina 1.0	2009	首次发布，速度快，精度高，横空出世
Vina 1.1.x	2010-2012	修复了一些bug，提升了稳定性
Vina 1.2.x	2020	重大更新！支持多线程，加入了新的打分函数

这里有个重点。Vina 1.2版本是一个分水岭。之前老版本是单线程的，跑起来慢，但结果稳定。1.2版本引入了多线程支持，你电脑CPU核心越多，跑得越快。

遇到1.0或者1.1的老版本怎么办？我建议你直接升级。老版本不支持一些新参数，我们在后面章节会讲到的高阶筛选技巧，很多都离不开1.2的新功能。

1.3 安装前的准备

工欲善其事，必先利其器。安装Vina之前，你得先看看自己的电脑环境。Vina的安装方式主要有两种：直接下载预编译程序和通过Conda安装。

我个人更推荐后一种，因为Conda能帮你把依赖关系理得清清楚楚，不会把系统环境搞得一团糟。

你需要准备什么？

• 操作系统：Windows、macOS、Linux都行。Vina是全平台支持的。
• Conda包管理器：如果你还没有，我强烈建议装一个Miniconda或Anaconda。
• 受体和配体文件：用来跑测试。别担心，一会儿我自己生成给你看。

为什么会推荐Conda？你想想看，未来我们还要装Pythons脚本、各种分析工具。用Conda统一管理，能省去很多编译环境冲突的麻烦。

1.4 跟我一步步安装

好，接下来我们实战。我假设你的电脑里已经装好了Conda。打开你的终端（Windows用户打开Anaconda Prompt）。

1.4.1 创建并激活环境

我习惯为每个计算项目单独创建一个虚拟环境，这样隔离性好，不会互相污染。

conda create -n vina_env python=3.9 -y
conda activate vina_env

看到了吗？我们创建了一个叫 vina_env 的环境，里面还顺手装上了Python 3.9. 后面写脚本会用到它。

1.4.2 使用Conda安装Vina

这一步最简单。一条命令搞定：

conda install -c conda-forge autodock-vina -y

等一下，这里必须提醒你一件事。我曾经在项目中遇到过安装后找不到 vina 命令的情况。那是因为conda的默认频道里没有。所以我这里指定了 -c conda-forge 这个频道，它里面有最全的科学计算软件包。

1.4.3 如果从源代码编译（Linux/Mac用户备用方案）

有些情况下，预编译的二进制文件可能不兼容你的系统。这时候就需要自己编译了。虽然稍微复杂一点，但掌控感强。

从GitHub把代码clone下来：

git clone https://github.com/ccsb-scripps/AutoDock-Vina.git
cd AutoDock-Vina

Vina 1.2.x使用C++编写，支持现代的CMake构建系统。编译命令如下：

mkdir build
cd build
cmake ..
cmake --build . -j$(nproc)

编译完成后，在 build 文件夹里会出现两个可执行文件：vina和vina_split。你可以把它们复制到系统路径，或者直接就在这个目录下运行。

1.5 环境配置验证

软件装好，能不能跑？得测一下才行。

我们来写一个最简单的测试。首先，你需要一个受体文件和一个配体文件。我用Vina自带的一个小例子来演示。

找一个干净的工作目录，我们利用Vina的 --help 参数来确认它活过来了：

vina --help

如果你能看到一堆参数说明，那就说明安装成功了。它的运行核心逻辑，我画了张图帮你理解。

看了这张图，对Vina的工作流心里有个谱了吧？

接下来，我们手动跑一个小例子。假设你已经准备好了文件（具体怎么生成，下一章细说），比如：

vina --receptor receptor.pdbqt --ligand ligand.pdbqt --out docking_output.pdbqt 
     --center_x 10.0 --center_y 15.0 --center_z 20.0 
     --size_x 20 --size_y 20 --size_z 20 --exhaustiveness 8

这条命令的意思是：告诉Vina，我的受体是 receptor.pdbqt，配体是 ligand.pdbqt，在空间中心 (10, 15, 20) 周围一个20立方埃的盒子里搜索，搜索的细致程度是8。

命令跑完，你会看到一个 docking_output.pdbqt 文件。如果没有报错信息，就说明一切正常。

1.6 常见问题与调试

安装过程中，你可能会遇到一些问题。我把最常见的几个列出来：