环境搭建：把KronaTools装进你的分析管道
Krona这东西，说白了就是一个能把物种丰度数据变成交互式饼图的HTML工具。但想让它跑起来，你得先把它的“发动机”装好。这一节咱们就聊安装——从conda、pip到源码，三种路径，一个目标。
安装路径一：conda（我推荐这个）
我个人习惯了用conda，尤其是做生信项目时。它能把perl、python和Krona本身的依赖一股脑儿管理好，省心。
conda install -c bioconda krona嗯，就这么简单。但有个小坑——频道优先级。如果你装了多个频道，bioconda的包可能被conda-forge的旧版覆盖。我的做法是显式指定频道:
conda install -c conda-forge -c bioconda krona我曾经在某个服务器上装完krona，跑ktImportText直接报错。查了半天，发现是conda-forge的perl版本和bioconda的krona不兼容。后来加了个-c conda-forge在前边，问题就解决了。
kronatools -v，确认版本号能出来。别等到分析时才发现没装对。
安装路径二：pip（Python生态的同学看过来）
如果你项目里全是Python，不想碰conda，那用pip也可以。不过要注意——Krona本质是Perl写的，pip只是装了个wrapper。
pip install krona装完后，核心脚本在Python的site-packages里。你可以找到它:
python -c "import krona; print(krona.__file__)"我个人觉得pip方式适合快速验证，但生产环境还是建议conda。为什么呢？pip装完你还得手动配perl模块，麻烦。
GD::Graph 和 GD::SVG 这两个perl模块。如果你遇到"Can't locate GD"之类的报错，别慌，用cpan手动补一下就行。
cpan install GD::Graph GD::SVG安装路径三：源码安装（适合深度定制）
想跟Krona源码亲密接触？那就走这条路。我从GitHub拉下来，自己配环境。
git clone https://github.com/marbl/Krona.git
cd Krona/KronaTools
./install.pl --prefix=$HOME/krona这里有个关键：--prefix决定了脚本装到哪。如果省略，默认装到/usr/local，需要root权限。我个人习惯装在用户目录下，方便管理。
装完后，把bin目录加到PATH里:
export PATH=$HOME/krona/bin:$PATH你想想看，源码安装的好处是什么？你可以直接改Perl脚本里的逻辑，比如自定义配色、修改饼图半径。我在做项目时，客户非要神灯色系的Krona图，我就是通过改KronaTools/lib/KronaDB.pm里的颜色数组搞定的。
验证安装：别跳过这一步
装完了，赶紧验证。我最怕学员说“我装了，但没测”，结果到做图时发现少了依赖。
三步验证法:
- 命令可用性检查
which kronatools
ktImportText -h如果输出帮助信息，基本稳了。
- 运行测试脚本
Krona包自带测试数据，跑一下:
ktImportText -o test.html KronaTools/data/test.txt生成一个test.html，浏览器打开——能看到交互式饼图吗？可以缩放、点击吗？如果一切正常，恭喜，环境搭好了。
- 检查版本
kronatools -v目前稳定版是2.8.x。如果你版本过低，建议升级。
ktImportText输出全是乱码。后来升级到perl 5.30就好了。嗯，perl版本别太老。
依赖检查：perl和python的“联姻”
Krona虽然以perl为核心，但现代版本也开始拥抱python。咱们来看看具体依赖。
| 依赖 | 最低版本 | 备注 |
|---|---|---|
| Perl | 5.20 | 核心引擎，必须 |
| GD::Graph | 2.55 | 用于png输出（非必须，但推荐） |
| GD::SVG | 0.33 | SVG支持，强烈推荐 |
| Python | 3.6 | 如果走pip安装，需要 |
检查perl模块的方法:
perl -e 'use GD::Graph; print "GD::Graph ok\n"'
perl -e 'use GD::SVG; print "GD::SVG ok\n"'如果报错，说明模块未安装。用cpan补上就行。
对于python，检查:
python3 --version如果低于3.6，建议升级。我遇到过python 3.5装krona时出现编码问题，后来改成3.8就没事了。
我用的一张图：环境搭建的“骨骼”
下面这张SVG图，我把整个环境搭建的流程画出来了。从三个安装路径到验证，再到依赖检查，用箭头串起来，你一眼就能看清全貌。
实践：碰到问题怎么办？
你可能会遇到各种报错。我把常见的列出来:
| 错误提示 | 原因 | 解决办法 |
|---|---|---|
| Can't locate GD.pm in @INC | 缺GD模块 | cpan install GD 或 apt install libgd-perl |
| ktImportText: command not found | PATH没配好 | 检查安装路径，加到.bashrc里 |
| ImportError: No module named 'krona' | pip安装不全 | 用pip list确认；如果缺，重装 |
| kronatools: Permission denied | 脚本没执行权限 | chmod +x <脚本路径> |
conda create -n krona-env -c bioconda krona，这样不会污染base环境。
好了，环境搭好，依赖配齐，验证通过——你离第一个交互式物种丰度报告只差一步了。嗯，咱们先歇口气，喝杯咖啡，后面章节会手把手带你从数据到出图，每一步都有坑，我帮你填平。