4、Vitis安装指南（下）：命令行静默安装方法、安装后的环境变量配置、验证安装是否成功
上一节我们聊了图形化安装，这次来点更硬核的——命令行静默安装。说实话，我平时在服务器上部署Vitis，十次有八次都用静默安装。为什么？因为快，而且可以写进脚本里一键搞定。你想想看，要是每次装个工具都得盯着GUI点下一步，那得多浪费时间。
4.1 命令行静默安装方法
静默安装的核心，就是用一个配置文件来告诉安装程序：你要装什么、装在哪、要不要装设备驱动。我个人习惯把配置文件命名为install_config.txt，放在安装包同目录下。
先看看配置文件长什么样：
# 安装路径
INSTALL_DIR=/tools/Xilinx/Vitis/2024.1
# 安装选项
INSTALL_OPTIONS=Vitis
# 是否安装设备驱动
INSTALL_DEVICE_DRIVERS=1
# 是否接受许可协议
ACCEPT_EULA=1
嗯，这里要注意几个关键点：
- INSTALL_DIR：路径不要有中文和空格，否则你会后悔的。我在项目中遇到过有人把路径写成
/我的工具/Vitis 2024，结果编译时各种路径解析错误，排查了半天。 - INSTALL_OPTIONS：可以填
Vitis、Vivado或者All。如果你只需要Vitis，就别装Vivado，省点硬盘空间。 - ACCEPT_EULA：必须设为1，否则安装程序会停下来等你手动确认。
配置文件准备好之后，执行安装命令：
./xsetup --batch Install --config install_config.txt
就这么一行，然后你就可以去喝杯咖啡了。安装过程大概需要15-30分钟，取决于你的机器性能。我曾经在服务器上同时部署6套Vitis环境，写个shell脚本循环跑，一晚上全搞定。
4.2 安装后的环境变量配置
装完Vitis，你以为就能直接用了？别急，还差一步——配置环境变量。说白了，就是告诉系统：Vitis的命令在哪、库文件在哪。
Vitis安装包自带了一个设置脚本，路径在：
<INSTALL_DIR>/Vitis/2024.1/settings64.sh
每次打开终端，你都得先source一下这个脚本：
source /tools/Xilinx/Vitis/2024.1/Vitis/2024.1/settings64.sh
但每次都手动敲一遍，太麻烦了。我建议你把它加到~/.bashrc里：
echo "source /tools/Xilinx/Vitis/2024.1/Vitis/2024.1/settings64.sh" >> ~/.bashrc
source ~/.bashrc
这样每次登录终端，环境变量就自动配好了。不过要注意，如果你同时装了多个版本的Vitis，别一股脑全加到bashrc里，否则版本冲突会让你抓狂。
4.3 验证安装是否成功
环境变量配好了，怎么知道装没装对？我一般用三步验证法：
- 检查版本号
vitis -version
如果能看到版本号输出，说明基本安装没问题。比如：
Vitis v2024.1 (64-bit)
SW Build 1234567
IP Build 7654321
- 检查关键工具
which v++
which xclbinutil
which emconfigutil
这三个命令如果能找到路径，说明Vitis的核心工具链都装好了。我遇到过有人vitis能跑，但v++找不到，结果是因为只装了Vivado没装Vitis。你想想看，这得多尴尬。
- 跑一个最小测试
创建一个最简单的hello world工程，验证编译流程：
mkdir vitis_test && cd vitis_test
v++ --version
echo "int main() { return 0; }" > test.cpp
v++ -t sw_emu --platform xilinx_u250_gen3x16_xdma_4_1_202210_1 -c -k test test.cpp
如果编译通过，没有报错，那恭喜你，Vitis安装成功了。
--platform参数要换成你实际有的平台。如果你没有U250板卡，可以用--platform xilinx_vck190_base_202410_1或者随便一个你安装时选的平台。否则会报"Platform not found"的错误。
4.4 常见问题与解决
安装过程中，我遇到过不少坑，挑几个典型的说说：
| 问题 | 原因 | 解决方法 |
|---|---|---|
| 静默安装卡在99% | 设备驱动安装失败 | 加--skip-device-drivers参数，驱动后面单独装 |
| source settings64.sh后vitis命令找不到 | 路径写错了 | 检查echo $XILINX_VITIS是否指向正确路径 |
| 编译时报libstdc++版本不对 | 系统gcc版本太老 | 升级gcc到9.0以上，或者用Vitis自带的gcc |
| v++报"Failed to load xrt" | XRT没装或者环境变量没配 | 重新source settings64.sh，或者手动添加XRT路径 |
嗯，基本上就这些。静默安装说白了就是写个配置文件、跑一条命令、配一下环境变量。熟练之后，5分钟就能搞定一套环境。比图形化安装快多了，而且不容易出错。
最后再啰嗦一句：装完之后，记得把安装包删了。一个安装包十几个G，留着也是占地方。我一般装完就删，反正配置文件留着，下次重装直接跑脚本就行。