Vivado 2021.1 安装实战：从零搭建 Zynq 开发环境，一次成功不踩坑
你是不是也经历过这样的场景？
刚拿到一块 PYNQ-Z2 或 Zybo Z7 开发板，满心欢喜想动手做点图像处理或嵌入式 AI 项目，结果第一步就被卡死在Vivado 安装上——启动报错、License 不识别、JTAG 找不到设备……折腾三天还没点亮一个 LED。
别急。这篇文章就是为你写的。
我们不讲空话套话，只聚焦一件事：如何在 Windows 或 Linux 环境下，干净利落地完成 Vivado 2021.1 的安装与配置，快速进入 Zynq 软硬件协同开发阶段。全程基于真实工程经验，避开了官方文档里没写但新手必踩的“暗坑”。
为什么是 Vivado 2021.1？不是最新版？
很多人第一反应是：“都 2025 年了，还用 2021.1？”
答案很简单：稳定、兼容、省心。
虽然 Xilinx（现 AMD）每年都会发布新版本，但对大多数 Zynq-7000 用户来说，2021.1 是一个被广泛验证过的“黄金版本”。它具备以下几个不可替代的优势：
- ✅ 支持 WebPACK 免费授权，可编译 XC7Z010/020 等主流低密度芯片；
- ✅ 对老旧 PC 和虚拟机更友好，安装包约 18GB，远小于 2023+ 版本的 30GB+；
- ✅ 第三方板卡支持完善，PYNQ、Digilent、米尔科技等均有成熟 Board Files；
- ✅ Bug 少，社区反馈多，出问题能搜到解决方案；
- ✅ 与 Vitis SDK 集成顺畅，适合教学和原型开发。
相比之下，新版 Vivado 常出现驱动冲突、许可证校验失败、Linux 下 GLIBC 不兼容等问题，反而拖慢进度。
所以，如果你的目标是快速上手 Zynq 开发而非尝鲜，选 2021.1 绝对是最务实的选择。
准备工作：别跳过这一步！
在点开xsetup.exe之前，请务必确认以下几点：
💾 硬盘空间 ≥ 30GB（强烈建议 SSD）
Vivado 实际占用可能超过 25GB，加上临时文件和工程目录，30GB 是底线。如果用机械硬盘，综合实现过程会慢得让你怀疑人生。
🚫 关闭杀毒软件 & 实时防护
尤其是 Windows Defender 和 360。它们会在后台扫描.dll和.so文件，导致安装中断或运行时报“无法加载库”。
🔌 使用原装 USB 线连接开发板
很多问题其实出在劣质线缆上。PYNQ-Z2 这类板子通过 microUSB 同时供电 + JTAG + UART，电压不稳就容易断连。
🌐 提前注册 Xilinx 账号
去 https://www.xilinx.com 注册一个免费账号，用于后续申请 WebPACK 许可证。邮箱建议用 Gmail 或企业邮箱，某些国内邮箱收不到验证邮件。
安装流程详解：Windows 与 Linux 双平台实操
步骤一：下载 Vivado HLx 2021.1 完整安装包
前往 Xilinx 官方归档页面：
👉 https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools/archive.html
找到Vivado HLx 2021.1，选择完整离线安装包（Offline Installer），根据系统下载对应版本：
| 操作系统 | 推荐镜像 |
|---|---|
| Windows 10/11 | xv211_Win64.iso |
| Ubuntu/CentOS | xv211_Lin64.iso |
⚠️ 注意：不要选 Web Installer！网络稍有波动就会失败。
挂载 ISO 后你会看到一个名为Xilinx_Vivado_SDK_2021.1_0603_1524的文件夹，进入即可运行安装程序。
步骤二：开始安装 —— 关键选项不能错
Windows 用户：
右键以管理员身份运行xsetup.exe
Linux 用户：
chmod +x ./xsetup sudo ./xsetup进入图形界面后，关键配置如下：
| 配置项 | 推荐设置 |
|---|---|
| Install Editions | Vivado HL Design Edition |
| Tools to Install | 必须勾选： ✔ Vivado ✔ Software Development Kit (SDK) ❌ Vivado HLS（除非你要做算法加速） ❌ Vitis Model Composer |
| Installation Location | 强烈建议全英文路径，如： Windows: D:\Xilinx\Vivado\2021.1Linux: /opt/Xilinx/Vivado/2021.1 |
❗特别提醒：路径中绝对不要有中文、空格或括号！否则后期导出 SDK 工程大概率失败。
点击 Next 直到 Finish，等待 30~60 分钟完成安装（SSD 更快）。
License 怎么搞？WebPACK 免费许可一键获取
没有 License，Vivado 只能打开旧工程，新建项目直接灰色禁用。
但好消息是：WebPACK 版本永久免费，且支持 Zynq-7000 中的 XC7Z010、XC7Z020 等常用型号。
获取步骤：
- 打开开始菜单 → Xilinx →Xilinx License Manager
- 点击 “Load License”
- 选择 “Connect now via internet”
- 登录你的 Xilinx 账户
- 勾选
Vivado_Lite_Edition或WebPACK许可，点击 “Get Selected License”
✅ 成功后状态显示为绿色勾选，Host ID 匹配当前机器 MAC 地址。
🔍 如果提示 “Invalid for this host”，说明 Host ID 变了（比如换了网卡、VM 迁移）。此时需重新生成 request file 并在线激活。
JTAG 驱动装不上？Digilent Adept 正确姿势
即使 Vivado 装好了，如果电脑识别不了开发板，一切等于零。
PYNQ-Z2、Zybo Z7 这些常见板子都使用 Digilent 的 USB-JTAG 方案，必须安装Adept Runtime才能通信。
下载地址：
👉 https://digilent.com/reference/software/adept/start
选择最新版 Adept 2.x（目前为 2.17），下载安装包。
安装要点：
- 安装时一定要勾选“Install cable drivers”
- 安装完成后重启电脑
- 插入开发板，观察设备管理器是否出现Digilent USB Device
💡 小技巧：可以用命令行工具
djtgcfg检查 JTAG 链状态：
djtgcfg enum # 查看已连接设备 djtgcfg info -d MyBoard # 显示详细信息若提示 “No devices found”，请尝试：
- 更换 USB 接口（优先使用主板后置接口）
- 更换数据线
- 卸载其他厂商的 JTAG 驱动（如 Intel USB-Blaster）
Linux 用户额外注意：udev 规则必须配
Ubuntu 用户常遇到权限问题，普通用户无法访问 USB 设备。
解决方法是添加 udev 规则：
sudo nano /etc/udev/rules.d/52-digilent.rules粘贴以下内容：
# Digilent Adept Rules SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6010", MODE="0666" SUBSYSTEM=="usb", ATTRS{idVendor}=="1443", ATTRS{idProduct}=="0007", MODE="0666" KERNEL=="ttyUSB*", ATTRS{idVendor}=="1443", ATTRS{idProduct}=="0007", MODE="0666"保存后执行：
sudo udevadm control --reload-rules sudo udevadm trigger拔插开发板，再次运行djtgcfg enum应能看到设备。
实战验证：5 分钟创建第一个 Zynq 工程
现在来验证整个环境是否可用。
目标：
创建一个包含 PS（ARM 处理器）和 PL（FPGA 逻辑）的基础工程，并导出到 SDK 输出 “Hello World”。
操作步骤：
- 打开 Vivado 2021.1
- 创建新工程 → 选择RTL Project
- 添加源码（可跳过）
- 在 Boards 选项卡搜索 “pynq”，选择PYNQ-Z2（确保板卡文件已加载）
- 创建 Block Design → 添加 IP：
ZYNQ7 Processing System - 双击进入配置界面 → 点击Run Block Automation
- 再次点击Validate Design（快捷键 Ctrl+Shift+V）
✅ 若无报错，说明硬件设计通过。
- 生成比特流（Generate Bitstream）
- 导出硬件至 SDK：File → Export → Export Hardware（包含 bitstream）
- 启动 Vitis：File → Launch Program → Xilinx Tools → Vitis
在 Vitis 中：
- 新建 Application Project
- 选择 Target Hardware Platform 为刚才导出的.hdf
- 选择模板：Hello World
- Build 并 Run 到 PYNQ-Z2
打开串口终端（如 Tera Term、PuTTY），波特率 115200，你应该能看到：
Hello from ARM!🎉 恭喜！你已经打通了 Zynq 开发的第一道关卡。
常见问题急救清单（收藏备用）
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| Vivado 启动闪退 | 缺少 VC++ 运行库 / 显卡驱动太旧 | 安装 Visual C++ Redistributable；更新显卡驱动 |
报错librdi_coretools.so加载失败（Linux） | GLIBC 版本过低 | 升级系统至 Ubuntu 20.04+，GLIBC ≥ 2.31 |
| JTAG 无法识别设备 | 驱动未安装 / 权限不足 / 线缆问题 | 重装 Adept；检查 udev 规则；换线 |
| License 显示无效 | Host ID 不匹配 | 重新生成 license request file 并在线激活 |
| 编译报错 “Part not supported in WebPACK” | 目标器件超出免费范围 | 更换为 XC7Z010/020 等支持型号 |
| SDK 导出失败 | 工程路径含中文或空格 | 使用纯英文路径重新建工程 |
| Vitis 启动卡住 | 内存不足 / 项目缓存损坏 | 分配至少 8GB JVM 内存；清理.metadata目录 |
最后一点建议：让环境更健壮
定期备份
.lic文件
路径通常位于：
Windows:C:\Users\<user>\.Xilinx\licenses
Linux:/home/<user>/.Xilinx/licenses
复制出来存到 U 盘，换电脑时直接导入。使用 Git 管理工程代码
忽略生成文件：gitignore *.runs/ *.hw/ *.sys/ *.bit *.bin保留一份最小可运行工程模板
包含基本 PS 配置 + UART + GPIO，下次直接复制复用。考虑使用 Docker 封装环境（进阶）
对于团队协作或实验室批量部署，可用容器化方式统一工具链版本。
如果你按照上述步骤操作，基本可以做到一次安装，长期稳定使用。再也不用因为环境问题耽误项目进度。
当然，如果在实操中遇到本文未覆盖的问题，欢迎留言交流。我们可以一起排查，把坑填平。
毕竟，真正的开发时间，应该花在创新上，而不是和安装程序斗智斗勇。
