3、Vitis安装指南（上）：从Xilinx官网下载安装包、安装前的系统检查与依赖库安装、图形化安装步骤详解。

3.1 下载安装包——别走错路

说实话，我第一次装Vitis的时候，在Xilinx官网上绕了半小时。页面跳来跳去，链接藏得深。后来摸清了门道，其实就几步。

你直接搜“Xilinx Vitis download”就行。或者记住这个路径：Xilinx官网 → Support → Downloads。进去之后选“Vitis Unified Software Platform”。

这里有个坑——安装包分两种：

在线安装器（几百MB的小文件，边下边装）
完整离线包（几十GB，适合一次下载多次安装）

我个人习惯用离线包。为什么？我在项目现场遇到过网络断断续续，在线安装器卡在50%不动，那叫一个尴尬。离线包虽然下载慢，但一次搞定，后面装十台机器都行。

小提示：下载前先注册Xilinx账号。没账号连下载按钮都点不了。注册免费，就是填个邮箱。

3.2 安装前的系统检查——别让环境坑了你

嗯，这里要重点说。我见过太多人下载完安装包，双击运行，然后报错。为什么？系统环境没准备好。

先看操作系统：

Ubuntu 18.04 / 20.04 / 22.04（LTS版本最稳）
CentOS 7 / 8（Red Hat系也行）
Windows 10 / 11（64位，专业版或企业版）

我用的是Ubuntu 20.04。说实话，Ubuntu对Xilinx工具支持最好，踩坑最少。Windows版也能用，但有些底层调试功能受限。

再看硬件：

项目	最低要求	推荐配置
CPU	4核	8核以上
内存	8GB	32GB
硬盘	100GB空闲	SSD 500GB
显示器	1280x1024	1920x1080

你想想看，Vitis装完就占30GB左右，再加上Vivado、各种库，100GB真不算多。我有个同事用256GB的笔记本，装完Vitis和Vivado，再放几个项目，直接红了。

警告：硬盘空间不够，安装过程中会直接报错退出。而且不会提示你“空间不足”，而是报一个莫名其妙的“写入失败”。我曾经被这个坑过，排查了半天。

3.3 依赖库安装——这一步最容易忘

说白了，Vitis是个Linux下的工具集。它依赖一堆系统库。你不装，它就不干活。

Ubuntu系统下，执行这条命令：

sudo apt-get update
sudo apt-get install -y \
  libncurses5 \
  libncurses5-dev \
  libncursesw5 \
  libtinfo5 \
  libc6-dev \
  libstdc++6 \
  libglib2.0-0 \
  libsm6 \
  libxrender1 \
  libfontconfig1 \
  libxext6 \
  libxtst6 \
  libxi6 \
  libxft2 \
  libx11-6 \
  libxcb1 \
  libxau6 \
  libxdmcp6 \
  libxpm4 \
  libxaw7 \
  libxmu6 \
  libxt6 \
  libxmuu1 \
  libxrandr2 \
  libxinerama1 \
  libxfixes3 \
  libxcursor1 \
  libxcomposite1 \
  libxdamage1 \
  libxss1 \
  libxxf86vm1 \
  libgl1-mesa-glx \
  libglu1-mesa \
  libegl1-mesa \
  libgles2 \
  libopencl1 \
  ocl-icd-libopencl1 \
  libssl-dev \
  libcurl4-openssl-dev \
  libxml2-dev \
  libxslt1-dev \
  python3 \
  python3-pip \
  python3-venv \
  make \
  gcc \
  g++ \
  gdb \
  cmake \
  git \
  wget \
  curl \
  unzip \
  xz-utils

这条命令我每次装新机器都跑一遍。你可能会问：“这么多库，都要装吗？”
嗯，其实不是每个都用得上。但你不装全，Vitis安装器检测到缺库，直接弹窗告诉你“缺少依赖”，然后退出。你想想看，装到一半卡住，多烦人。

CentOS/RHEL系统下：

sudo yum install -y \
  ncurses-libs \
  ncurses-devel \
  libtinfo \
  glib2 \
  libSM \
  libXrender \
  fontconfig \
  libXext \
  libXtst \
  libXi \
  libXft \
  libX11 \
  libXcb \
  libXau \
  libXdmcp \
  libXpm \
  libXaw \
  libXmu \
  libXt \
  libXmuu \
  libXrandr \
  libXinerama \
  libXfixes \
  libXcursor \
  libXcomposite \
  libXdamage \
  libXss \
  libXxf86vm \
  mesa-libGL \
  mesa-libGLU \
  mesa-libEGL \
  mesa-libGLES \
  ocl-icd \
  openssl-devel \
  libcurl-devel \
  libxml2-devel \
  libxslt-devel \
  python3 \
  python3-pip \
  make \
  gcc \
  gcc-c++ \
  gdb \
  cmake \
  git \
  wget \
  curl \
  unzip \
  xz

  重点：装完依赖库后，重启一下系统。别问我为什么，有些库的加载需要重启才能生效。我试过不重启直接装Vitis，结果卡在“检测系统环境”那一步，重启后一次过。

3.4 图形化安装步骤——跟着点就行

好，现在系统准备好了，安装包也下载好了。我们开始装。

第一步：解压安装包

如果你下载的是离线包（比如 Xilinx_Vitis_2023.1_0522_1443.tar.gz），先解压：

tar -xzf Xilinx_Vitis_2023.1_0522_1443.tar.gz
cd Xilinx_Vitis_2023.1_0522_1443

第二步：运行安装脚本

./xsetup

这时候会弹出一个图形界面。嗯，如果你在远程服务器上装，记得用 ssh -X 或者 vnc，不然看不到界面。

第三步：跟着向导走

欢迎页：点 Next
许可协议：勾选“I Agree”，点 Next
选择产品：勾选“Vitis”和“Vivado”（如果你需要硬件开发）。点 Next
选择版本：选“Vitis Unified Software Platform”。点 Next
选择组件：这里可以选你要支持的器件系列。比如：
- Zynq-7000
- Zynq UltraScale+ MPSoC
- Versal
- Kintex/Virtex 等
我个人习惯全选。虽然占空间，但后面不用再补装。你想想看，项目中途发现缺器件库，再跑一遍安装器，多折腾。
安装路径：默认是 /opt/Xilinx。我建议别改。有些脚本写死了路径，改了可能出问题。
确认信息：检查一下安装路径、组件列表。点 Install

第四步：等待安装完成

这个过程大概30分钟到1小时，取决于你的机器性能和选择的组件数量。去泡杯咖啡吧。

小技巧：安装过程中，可以在终端里看到详细的日志输出。如果卡住了，看看最后一条日志，通常能定位问题。比如“缺少libxxx.so”，那就是依赖库没装全。

3.5 安装后的验证——确认装好了

装完别急着关。先验证一下：

source /opt/Xilinx/Vitis/2023.1/settings64.sh
vitis -version

如果能看到版本号，比如 Vitis v2023.1 (64-bit)，那就成了。

再跑个简单的测试：

vitis -h

能看到帮助信息，说明环境变量也配好了。

注意：每次打开新终端，都要 source settings64.sh。我建议把这行加到 ~/.bashrc 里，省得每次手动敲。

3.6 本章知识体系

下面这张图，把整个安装流程串起来了。你跟着走，基本不会出错。

这张图把整个流程串起来了。你跟着走，基本不会出错。如果卡在哪一步，回头看看对应的章节。

好了，安装部分的上半段就到这。下一章我们继续讲安装后的配置、License激活，还有第一个Hello World工程怎么跑起来。

📚 课程目录

3、Vitis安装指南（上）：从Xilinx官网下载安装包、安装前的系统检查与依赖库安装、图形化安装步骤详解。

3.1 下载安装包——别走错路

3.2 安装前的系统检查——别让环境坑了你

3.3 依赖库安装——这一步最容易忘

3.4 图形化安装步骤——跟着点就行

3.5 安装后的验证——确认装好了

3.6 本章知识体系