第二章：开发环境搭建

好，咱们正式开始动手了。这一章要解决一个最实际的问题——怎么把Vitis和Vivado装好、配好、跑通。我见过太多新手卡在这一步，装了半天结果跑不起来，心态直接崩了。别急，跟着我的节奏来，一步步走稳。

2.1 安装前的准备工作

先说说硬件要求。Vitis和Vivado都是吃资源的大户，我自己的主力机是64GB内存、8核CPU、1TB SSD，跑起来还算顺畅。如果你用的是16GB内存的机器，嗯，可能会有点吃力，尤其是综合和实现的时候。

硬件/软件 最低要求 推荐配置
内存 16 GB 32 GB 或以上
CPU 4 核 8 核或以上
硬盘 100 GB 空闲 500 GB SSD
操作系统 Ubuntu 18.04 / CentOS 7 Ubuntu 20.04 / RHEL 8

我个人习惯用Ubuntu 20.04 LTS，兼容性最好，踩坑最少。Windows也能用，但有些脚本和路径问题会让你多花不少时间。

2.2 下载安装包

去Xilinx官网下载Vitis统一软件平台。注意，Vitis 2023.1及以后的版本已经包含了Vivado，不需要单独下载。你只需要下载一个安装包就行。

下载前记得注册一个Xilinx账号，免费的。我当年第一次下载时没注意，选了“Vitis only”，结果发现没有Vivado，又重下一遍，白白浪费半天时间。你选的时候看清楚：Vitis Unified Software Platform，里面包含了Vivado、Vitis、Vitis HLS等全套工具。

注意：安装包大约40-60GB，建议用有线网络下载。WiFi下载容易断，断了重来很痛苦。

2.3 安装Vitis统一软件平台

下载完成后，解压安装包。然后运行安装脚本：

# 解压
tar -xzvf Xilinx_Vitis_2023.1_*.tar.gz

# 进入目录
cd Xilinx_Vitis_2023.1_*

# 运行安装
./xsetup

安装界面是图形化的，跟着向导走就行。这里有几个关键点：

  • 选择安装组件：勾选“Vitis”和“Vivado”，其他按需选。我一般会把“Devices”里的所有器件都勾上，省得后面换芯片又要重装。
  • 安装路径：默认是 /tools/Xilinx，我建议不要改。如果改到有中文或空格的路径，后面会出各种奇怪的问题。
  • 许可证：安装时可以不填，后面再配置。但如果你有Node-Locked License，直接导入会更省事。

安装过程大概需要30分钟到1小时，取决于你的硬盘速度。这时候可以去泡杯咖啡，或者看看文档。

小技巧：安装完成后，检查一下 /tools/Xilinx/Vitis/2023.1/bin/ 目录下有没有 vitis 和 vivado 这两个可执行文件。如果有，说明安装基本成功了。

2.4 安装Xilinx Vivado

如果你下载的是Vitis统一平台，Vivado已经包含在里面了，不需要单独安装。但如果你用的是老版本（比如Vivado 2020.2），那就需要单独下载安装。

单独安装Vivado的步骤和上面类似：

# 解压
tar -xzvf Xilinx_Vivado_2020.2_*.tar.gz

# 运行安装
./xsetup

安装时选择“Vivado HL WebPACK”或“Vivado HL Design Edition”。WebPACK是免费的，但支持的器件有限。如果你用的是Zynq-7000或Artix-7，WebPACK就够了。如果是Kintex、Virtex这些高端系列，需要Design Edition。

我曾经有个项目用Kintex-7，结果WebPACK不支持，又得重装Design Edition。所以，提前查清楚你的目标器件在不在支持列表里。

2.5 配置环境变量

安装完只是第一步，还得让系统能找到这些工具。配置环境变量是必须的，不然你每次都要输完整路径，太麻烦了。

我个人习惯把环境变量写在 ~/.bashrc 里，这样每次打开终端都会自动加载。

# 编辑 .bashrc
vim ~/.bashrc

# 在文件末尾添加以下内容
export XILINX_VIVADO=/tools/Xilinx/Vivado/2023.1
export XILINX_VITIS=/tools/Xilinx/Vitis/2023.1
export XILINX_HLS=/tools/Xilinx/Vitis_HLS/2023.1
export PATH=$PATH:$XILINX_VIVADO/bin:$XILINX_VITIS/bin:$XILINX_HLS/bin

# 保存退出后，使配置生效
source ~/.bashrc

这里要注意路径版本号，我写的是2023.1，你根据自己安装的版本改一下。

避坑指南：我曾经遇到过一个问题——环境变量配好了，但Vivado还是找不到。后来发现是 LD_LIBRARY_PATH 没配。如果你也遇到类似问题，可以加上： 
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$XILINX_VIVADO/lib/lnx64.o

2.6 验证安装是否成功

环境变量配好了，怎么知道装没装对？很简单，跑几个命令验证一下。

2.6.1 验证Vivado

# 查看版本
vivado -version

# 如果输出类似以下内容，说明安装成功
Vivado v2023.1 (64-bit)
SW Build 1234567 on 2023-04-01

如果提示“command not found”，说明环境变量没配好，或者安装路径不对。回去检查一下。

2.6.2 验证Vitis

# 查看版本
vitis -version

# 输出类似
Vitis v2023.1 (64-bit)
SW Build 1234567 on 2023-04-01

2.6.3 验证Vitis HLS

# 查看版本
vitis_hls -version

# 输出类似
Vitis HLS v2023.1 (64-bit)
SW Build 1234567 on 2023-04-01

三个命令都跑通了，说明安装基本没问题。但为了保险，我建议再跑一个简单的测试：

# 创建一个临时目录
mkdir test_vivado && cd test_vivado

# 创建一个简单的Tcl脚本
echo "create_project test_project -part xc7z020clg400-1" > test.tcl
echo "exit" >> test.tcl

# 用Vivado运行这个脚本
vivado -mode batch -source test.tcl

如果Vivado能正常创建工程并退出，说明安装完全OK。

小提示：第一次运行Vivado时，可能会弹出许可证配置窗口。如果你没有许可证，可以用WebPACK的免费许可证，或者申请30天试用版。我刚开始学的时候就是用试用版，完全够用。

2.7 常见问题与解决

安装过程中难免会遇到问题，我整理了几个最常见的：

  • 安装卡在99%：通常是网络问题，或者硬盘空间不足。检查一下 /tmp 目录有没有足够空间，至少留20GB。
  • Vivado启动报错“libtinfo.so.5 not found”：这是Ubuntu 22.04的常见问题。解决方法：sudo apt install libtinfo5。
  • Vitis打不开GUI：检查一下Java环境。Vitis依赖Java 11，可以用 java -version 查看版本。

我曾经在Ubuntu 22.04上装Vitis 2022.2，结果死活打不开GUI，折腾了两天才发现是Java版本不对。从那以后，我装新版本前都会先看Release Notes，里面会写明依赖的软件版本。

2.8 本章知识体系

下面这张图总结了本章的核心流程，你可以对照着检查自己走到哪一步了：

开发环境搭建流程 1. 硬件检查 2. 下载安装包 3. 安装Vitis/Vivado 4. 配置环境变量 5. 验证安装 6. 常见问题排查 ✅ 安装成功 ❌ 排查问题 返回检查环境变量或安装

这张图把整个流程串起来了。你从硬件检查开始，一步步往下走，最后要么成功，要么回到问题排查。说白了，安装环境就是个“试错-修正”的过程，别怕出错。

好了，环境搭好了，下一章咱们就开始真正干活了——创建第一个Vitis平台工程。

可可精品资料库

← 上一章 📖 返回目录 下一章 →