手把手带你零失误安装 Vivado 2019.1:从下载到验证的完整实战指南
你是不是也曾在尝试搭建 FPGA 开发环境时,被各种“安装失败”、“许可证缺失”、“器件找不到”的报错搞得焦头烂额?明明照着教程一步步来,可 Vivado 就是打不开、跑不起来。
别急——这几乎是每个刚接触 Xilinx FPGA 的工程师都踩过的坑。而问题的根源,往往不是技术本身,而是安装过程中的细节没把控好。
今天,我们就以Vivado 2019.1为例,带你走完一次真正可靠、可复现、零翻车的全流程安装。无论你是学生、科研人员还是嵌入式开发者,只要跟着本文操作,就能在 Windows 或 Linux 上稳稳装上这套强大的开发工具链。
为什么选 Vivado 2019.1?
虽然现在最新版已经更新到 Vitis 和 2023.x 版本,但2019.1依然是许多高校课程、企业项目和开源社区广泛使用的“黄金版本”。
它有几个不可替代的优势:
- ✅ 属于官方认证的长期支持版本(LTS),稳定性强;
- ✅ 对 Zynq-7000、Artix-7、Kintex-7 等主流器件支持完善;
- ✅ WebPACK 免费版功能完整,无需破解或盗版;
- ✅ UI 响应流畅,资源占用相比新版更友好;
- ✅ 大量教学视频、实验例程、开源项目均基于此版本。
更重要的是:它的安装流程清晰、文档齐全、出错可查,非常适合新手入门。
安装前必看:软硬件准备清单
在动手之前,请先确认你的系统满足以下条件。
✅ 系统要求(Windows / Linux)
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 7/10/11(64位) Ubuntu 16.04/18.04、CentOS 7+ |
| CPU | 四核及以上(推荐 Intel i5/i7 或 AMD Ryzen) |
| 内存 | ≥ 8GB(建议 16GB 以上) |
| 存储空间 | ≥ 50GB 可用空间(SSD 更佳) |
| 显卡 | 支持 OpenGL 3.0+(集成显卡基本够用) |
⚠️ 特别提醒:
- 不要在机械硬盘上运行大型综合任务;
- 避免使用虚拟机(尤其是 VMware 默认设置),容易导致 SDK 启动崩溃;
- 若使用 WSL,请确保是 WSL2 并挂载本地路径。
📦 下载资源准备
你需要获取两个核心文件:
Vivado 安装包
- 名称:Xilinx_Vivado_SDK_Web_2019.1_0524_1.tar.gz(Linux)
- 或Xilinx_Vivado_SDK_Web_2019.1_0524_1.zip(Windows)
- 大小约 20~25 GBXilinx 账户
- 必须注册 https://www.xilinx.com 账号
- 使用真实邮箱,需完成验证
📌 获取方式:
- 登录官网 → Support & Downloads → Search “Vivado HLx 2019.1 Full Installer”
- 选择对应平台下载(注意不要下成 Web Installer,那是在线安装器,极慢且易断)
💡 推荐使用迅雷、IDM 等多线程工具加速下载,并校验 SHA256 值防止损坏。
第一步:解压安装包(关键!路径不能有中文)
这是很多人第一次栽跟头的地方。
Windows 用户
将压缩包解压到一个纯英文、无空格、无特殊字符的路径
例如:D:\Xilinx\Vivado_2019.1\使用 7-Zip 或 WinRAR 解压(不要双击直接打开)
❌ 错误示例:
C:\Users\张三\Desktop\Vivado安装包\
✅ 正确示例:D:\Xil\Install\进入目录后找到
xsetup.exe—— 这是我们的启动程序
Linux 用户
# 解压 tar -zxvf Xilinx_Vivado_SDK_Web_2019.1_0524_1.tar.gz # 进入目录 cd Xilinx_Vivado_SDK_Web_2019.1_0524_1 # 给安装脚本加执行权限 chmod +x xsetup # 启动图形化安装 ./xsetup🔍 提示:如果你是在无 GUI 的服务器上安装,可以加上
-b Win64参数进行静默安装(headless mode),我们后面会讲。
第二步:启动安装向导(图文详解每一步)
双击xsetup后进入图形化安装界面。以下是每一个步骤的详细说明。
步骤 1:欢迎页 → 直接点 Next
没啥好说的,欢迎来到 Xilinx 世界 😄
步骤 2:登录账户
输入你在 xilinx.com 注册的账号密码。
⚠️ 注意:
- 必须登录才能继续;
- 如果提示“Invalid credentials”,检查是否邮箱未验证或输错了密码;
- 可点击 “Create Account” 注册新用户(免费)。
勾选同意协议(I accept the terms…)→ Next
步骤 3:选择安装类型(重点!选对才省事)
这里有三个选项:
| 选项 | 说明 | 是否推荐 |
|---|---|---|
| Vivado HL Design Edition | 商业版,含 HLS、System Generator | ❌(需要付费 license) |
| Vivado HL WebPACK Edition | 免费版,支持大部分主流器件 | ✅✅✅ 强烈推荐 |
| Vivado SDK | 嵌入式开发组件(建议一起装) | ✅ 勾选 |
📌强烈建议选择:
👉“Vivado HL WebPACK and Vitis Embedded Development”
这样你可以同时拥有:
- FPGA 逻辑设计能力(Verilog/VHDL)
- IP Integrator 图形化建模
- SDK 工具用于 Zynq 软核编程
- Tcl 脚本自动化支持
步骤 4:设置安装路径(别往 C 盘塞!)
默认路径一般是:
- Windows:
C:\Xilinx\Vivado\2019.1 - Linux:
/tools/Xilinx/Vivado/2019.1
但我们建议改到其他分区,比如:
D:\Xilinx\Vivado\2019.1 ← 推荐!原因很简单:Vivado 安装后占用接近 30GB,加上工程缓存很容易撑爆系统盘。
步骤 5:选择组件(按需勾选,别贪多)
点击左侧菜单,展开 “Device Families” 和 “Optional Software Components”。
推荐勾选项如下:
✅必选(通用配置)
[x] Documentation Navigator
(离线文档神器,查 IP 核参数不用联网)[x] Device Families:
- Artix-7
- Kintex-7
- Virtex-7
- Zynq-7000 AP SoC
Spartan-7(可选)
[x] Simulator Libraries → Compile for ModelSim/QuestaSim
(仿真必备,提前编译好库能提速 80%)[x] LabTools
(JTAG 下载、ILA 调试、VIO 控制都靠它)[x] Tcl Store, Package Manager
(方便后期扩展插件)
❌ 不推荐初学者安装(太占空间):
- ISE Simulator (ISIM)
- PlanAhead
- ChipScope Pro
📌 小技巧:如果不确定以后要不要某个系列,先不装也没关系,后续可以通过重新运行xsetup添加组件。
步骤 6:开始安装!
点击 “Install” 按钮,静静等待。
📌 安装时间参考:
- SSD + i7 CPU:约 40 分钟
- HDD + 旧电脑:可能超过 90 分钟
进度条会显示各模块安装状态,期间请勿关机、休眠或断电。
❗ 常见错误处理:
问题:安装中途弹窗 “Failed to copy file”
解决方法:
- 关闭杀毒软件(如 360、McAfee)
- 以管理员身份运行xsetup.exe
- 更换安装路径为短路径(如D:\Xil\Vivado\2019.1)
第三步:激活许可证(WebPACK 免费授权怎么拿?)
安装完成后首次启动 Vivado,会自动弹出 License Manager。
方法一:一键获取免费许可证(推荐)
- 打开 Vivado
- 点击 Help → License Manager
- 在窗口中点击 “Get Free ISE/WebPACK License”
- 登录你的 Xilinx 账户
- 自动下载并激活
.lic文件
成功后你会看到:
✅WebPACK_License状态为Active
✅ 支持的器件列表没有红色叉号 ❌
方法二:手动导入许可证(备用方案)
如果自动获取失败,可以手动操作:
- 访问: https://www.xilinx.com/getlicense
- 登录后点击 “Download License”
- 得到一个名为
Xilinx.lic的文件 - 在 Vivado 中点击 Load License → 选择该文件
💡 技巧:把这个
.lic文件备份一份,换电脑时直接导入即可,不用再申请。
第四步:配置环境变量(让你能在命令行调用 vivado)
为了方便使用脚本构建项目、远程部署或 CI/CD 集成,我们需要把 Vivado 加入系统路径。
Windows 平台
- 打开“系统属性” → “高级” → “环境变量”
在 “系统变量” 中找到
Path,编辑 → 新增:C:\Xilinx\Vivado\2019.1\bin打开 CMD 测试:
cmd vivado -version
输出应为:Vivado v2019.1 (64-bit)
Linux 平台
编辑~/.bashrc文件:
nano ~/.bashrc在末尾添加:
export XILINX_VIVADO=/tools/Xilinx/Vivado/2019.1 export PATH=$XILINX_VIVADO/bin:$PATH保存退出后刷新环境:
source ~/.bashrc vivado -version✅ 成功输出版本号即表示配置完成。
实战验证:创建第一个工程测试安装是否成功
让我们新建一个最简单的工程,验证整个工具链是否正常工作。
步骤如下:
- 打开 Vivado
- Create New Project → 输入名称
test_proj - Project Type 选 RTL Project
- 添加空白 Verilog 文件(可跳过)
- 在 Board 选择页面,搜索
ZedBoard或Arty A7 - 完成创建
🔍 观察点:
- 能否顺利进入主界面?
- 是否能找到目标器件?
- Tcl Console 是否可用?
如果都能做到,恭喜你,Vivado 2019.1 已经成功落户你的电脑!
常见问题与避坑指南(血泪经验总结)
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 安装时报错“Permission denied” | 权限不足 | 以管理员身份运行安装程序 |
| 启动时提示“No license found” | 未登录或未下载 lic | 手动去 getlicense 下载导入 |
| 找不到 Zynq-7000 器件 | 未安装对应 Device Family | 回到安装目录重跑xsetup补装 |
| SDK 打不开,闪退 | Java 内存溢出 | 设置_JAVA_OPTIONS=-Xmx2g |
| 仿真库编译失败 | 路径含中文或空格 | 检查 ModelSim 安装路径 |
📌 特别提醒:
- 不要用中文用户名登录系统(会导致%APPDATA%路径乱码)
- 不要将工程放在桌面或文档目录(路径太长易出错)
- 定期清理%APPDATA%\Xilinx和.Xil缓存目录
进阶技巧:多版本共存 & 快速切换
你可能会遇到这种情况:
- 项目 A 需要用 2018.3
- 项目 B 必须用 2019.1
- 项目 C 要上 2020.2
怎么办?难道要反复卸载重装?
当然不用!Xilinx 支持多版本共存。
方法很简单:
每个版本安装到独立目录:
-D:\Xilinx\Vivado\2018.3
-D:\Xilinx\Vivado\2019.1
-D:\Xilinx\Vivado\2020.2创建多个快捷方式,分别指向不同版本的
vivado.bat修改快捷方式名称为:
- Vivado 2019.1
- Vivado 2020.2右键固定到任务栏,随时切换
💡 小技巧:你还可以写个批处理脚本快速启动指定版本。
总结:掌握安装 = 掌握主动权
看到这里,你应该已经完成了从零到一的跨越。回顾一下我们走过的路:
- ✅ 准备了正确的安装包和账户
- ✅ 完成了无错误的解压与安装
- ✅ 成功获取了免费 WebPACK 许可证
- ✅ 配置了环境变量支持命令行调用
- ✅ 验证了工程创建与器件识别
这些看似琐碎的步骤,其实是你未来所有 FPGA 开发工作的基石。一个稳定的开发环境,胜过十倍的努力调试。
接下来,你可以尝试:
- 用 IP Integrator 搭一个 AXI GPIO 控制 LED
- 导出硬件到 SDK 写个裸机程序
- 用 ILA 抓信号做时序分析
而这一切的前提,是你有一个能正常运行的 Vivado。
如果你在安装过程中遇到了本文未覆盖的问题,欢迎留言讨论。也可以分享给正在被“安装难题”困扰的同学朋友——有时候,一篇靠谱的教程,真的能少熬好几个通宵。