Vivado 2019.2 安装全攻略：从下载到环境检查的完整指南

1. 为什么我至今还在用 Vivado 2019.21.1 一个“老版本钉子户”的真实自白先说结论我手头至少有三台机器上同时装着 Vivado 2019.2、2020.2 和更新的版本但真正干活最多的还是 2019.2。这不是我懒也不是我怀旧而是被现实反复教育之后的结果。Vivado 是 Xilinx现在叫 AMD 了但老工程师嘴里还是习惯叫 Xilinx家的 FPGA 集成开发环境从 RTL 综合、实现、布局布线到生成比特流、硬件调试、SDK 软件开发一条龙全包。2019.2 这个版本发布于 2019 年下半年属于 2019 系列的第二个大版本更新也是很多经典器件和 IP 核支持最成熟、最稳定的一个版本。为什么推荐它几个很实在的理由器件支持覆盖面广从老一代的 Spartan-7、Artix-7、Kintex-7、Virtex-7到 Zynq-7000 系列再到 UltraScale 和 UltraScale2019.2 基本全覆盖。很多学校实验室、公司老项目用的就是 7 系列和 Zynq-7000这个版本刚好是“甜点版本”。IP 核兼容性好像 AXI DMA、AXI Ethernet、MIPI、Aurora 8b/10b 这些常用 IP在 2019.2 里的版本经过大量项目验证坑相对少。新版本有时候 IP 升级了接口变了老工程迁移反而麻烦。教程和资料多网上大量 FPGA 入门教程、项目实战视频用的都是 2019.2。你跟着做版本一致少踩很多“版本不对导致报错”的坑。对电脑配置相对友好虽然 Vivado 从来都吃内存但 2019.2 相比后面几个大版本对硬盘和内存的胃口还算克制。16GB 内存 固态硬盘跑中小规模工程基本够用。所以这篇文章我就把自己反复安装 Vivado 2019.2 的经验完整梳理一遍。从下载、解压、安装、License 处理到安装后必做的环境检查再到常见报错怎么排查全部讲清楚。适合刚入门的 FPGA 新手也适合需要重装环境的老手对照检查。提示安装包体积很大完整版解压后接近 30GB安装完占用 40GB 以上。动手之前先确认硬盘空间别装到一半发现空间不够那才叫难受。1.2 安装之前必须搞清楚的几件事很多人一上来就双击安装程序结果卡在某个步骤反复失败。其实安装前花十分钟做功课能省下后面两小时折腾。第一确认你的操作系统版本。Vivado 2019.2 官方支持 Windows 10 64 位、Windows 7 SP1 64 位、部分 Linux 发行版Ubuntu 16.04/18.04、CentOS 7 等。注意是 64 位32 位系统直接不用考虑。Windows 11 官方没在支持列表里但实测大部分情况能装能用只是偶尔会有界面渲染的小问题。第二确认内存和硬盘。官方建议 8GB 内存起步但那是“能打开软件”的底线。真正跑综合和实现16GB 是舒适线32GB 更稳。硬盘方面安装包下载下来约 20GB 左右不同版本略有差异解压后安装文件再加安装后的程序总共预留 50GB 比较保险。强烈建议装在固态硬盘上机械硬盘跑 Vivado 会让你怀疑人生。第三想清楚要装哪些器件库。Vivado 安装时可以勾选需要支持的器件系列。如果你只玩 7 系列和 Zynq-7000就没必要把 UltraScale 全勾上能省下十几个 GB。但如果你不确定以后会用什么全勾也行就是占地方。第四提前准备好安装包。标题里提到“附安装包”我这里说明一下安装包一般来自官方渠道通过 Xilinx/AMD 官网账号登录后可以下载对应版本的 Unified Installer。网上流传的整合包大多是别人下载后打包的用之前最好核对一下文件完整性避免解压出错。2. 安装包获取与解压的实操细节2.1 安装包从哪来怎么判断是否完整正规途径是去 AMD/Xilinx 官网注册账号后进入下载页面找到 Vivado 2019.2 的 Unified Installer。官网提供的是在线安装器Web Installer和完整离线安装包Full Installer两种。我强烈建议用完整离线安装包原因很简单在线安装器一边下一边装网络一抖就前功尽弃而且没法复用。离线包下载一次以后重装、给同事拷贝都方便。下载下来通常是一个大的压缩包或者一个自解压的 exe。以 Windows 为例常见形式是Xilinx_Vivado_SDK_2019.2_xxxx.tar.gz或者分卷压缩包。文件大小在 20GB 上下具体取决于包含的器件库。怎么判断下载完整最靠谱的办法是对比官方给出的 MD5 或 SHA256 校验值。Windows 上可以用certutil命令certutil -hashfile Xilinx_Vivado_SDK_2019.2_xxxx.tar.gz SHA256Linux 上更简单sha256sum Xilinx_Vivado_SDK_2019.2_xxxx.tar.gz算出来的值和官方页面给的一致才说明文件没损坏。这一步很多人跳过结果解压到一半报“文件损坏”又得重新下载得不偿失。注意网上有些打包好的安装包为了压缩体积用了比较激进的压缩算法解压时对内存有一定要求。如果解压报错先换一个解压工具试试比如 7-Zip 最新版别用系统自带的。2.2 解压路径的选择有讲究解压路径这件事我踩过坑必须单独说。不要放在中文路径下不要放在带空格的路径下。这是铁律。Vivado 的安装脚本和一些底层工具对路径里的非 ASCII 字符和空格处理得不好轻则安装报错重则装完了某些功能莫名其妙不能用。我一般直接解压到根目录下的英文文件夹比如D:\Xilinx_Install\。路径不要太深。Windows 有路径长度限制虽然现在系统可以开启长路径支持但 Vivado 内部有些脚本还是老式的路径太深容易触发“文件名过长”的错误。建议解压后的完整路径控制在三四层以内。预留足够空间。解压过程本身需要额外空间因为压缩包和解压出来的文件会同时存在。等安装完成、确认没问题之后再删掉解压出来的临时文件。解压时间取决于硬盘速度固态硬盘大概十几分钟到半小时机械硬盘可能要一个小时以上。这段时间可以去干点别的别守着进度条。2.3 安装前的系统环境检查正式双击安装程序之前我习惯做几个检查能避免大部分“安装程序闪退”的问题。关闭杀毒软件和系统防护的实时监控不是让你永久关闭而是安装期间临时关掉。Vivado 安装过程会释放大量可执行文件和脚本杀毒软件容易误报拦截导致安装中断或者装出来的东西不完整。确认当前用户有管理员权限Windows 上安装驱动组件比如 cable driver需要管理员权限。右键安装程序选择“以管理员身份运行”。检查系统区域设置如果系统区域设置不是中文中国或者英文美国有时候会导致安装界面乱码。控制面板里把“非 Unicode 程序的语言”改成中文或英文都行。临时关闭 Windows Defender 的“受控文件夹访问”这个功能有时候会阻止安装程序往某些目录写文件。这些检查看起来琐碎但每一条我都见过有人栽在上面。尤其是杀毒软件国产某数字卫士拦截 Xilinx 安装程序那是家常便饭。3. 手把手安装流程与关键选项解析3.1 启动安装程序与欢迎界面找到解压目录下的xsetup.exeWindows或者xsetupLinux右键以管理员身份运行。稍等片刻会出现 Vivado 的安装欢迎界面。第一屏通常让你选择安装类型一般有“Vivado HL WebPACK”“Vivado HL Design Edition”“Vivado HL System Edition”等选项。这里解释一下区别版本类型适用场景器件支持是否免费HL WebPACK学习、小项目部分小容量器件免费HL Design Edition逻辑设计为主大部分器件需 LicenseHL System Edition含 SDK、嵌入式全部器件需 LicenseSDx 系列高层次综合特定器件需 License对于绝大多数入门和中小项目WebPACK 版本就够了而且免费。它支持的器件包括 Artix-7 大部分型号、Zynq-7010/7020、Spartan-7 等学校实验和很多开源项目用的都是这些。如果你手头的板子是 Kintex-7 或者更大容量的器件那就得选 Design Edition 或 System Edition需要对应的 License。选好版本后点 Next进入器件库选择界面。3.2 器件库勾选省空间的关键一步这一屏是很多人纠结的地方。界面会列出所有可选的器件系列和开发板每个前面有复选框。我的建议是按需勾选但留一点余量。如果你明确知道自己只用 Zynq-7020那就只勾 Zynq-7000 系列加上 7 系列里的 Artix-7。这样安装体积能控制在 20GB 以内。如果你不确定或者想以后玩各种板子那就把 7 系列、Zynq-7000、UltraScale 都勾上体积会到 30GB 以上。有一个细节Install Cable Drivers 这个选项一定要勾上。这是下载器驱动没有它你后面连板子下载程序的时候电脑识别不到下载器会浪费很多时间去找驱动。安装过程中会自动装好省心。另外SDK 和 DocNav 建议一起装。SDK 是做 Zynq 嵌入式开发的必备工具DocNav 是本地文档浏览器查 IP 手册和用户指南很方便不用每次都上网找。3.3 安装路径与快捷方式设置安装路径同样遵循“英文、无空格、不太深”的原则。默认路径通常是C:\Xilinx\Vivado\2019.2如果你 C 盘空间紧张改到 D 盘或 E 盘。我一般用D:\Xilinx\Vivado\2019.2。安装程序会问你是否创建桌面快捷方式和开始菜单项都勾上方便以后启动。接下来是确认信息页面把前面选的版本、器件、路径再核对一遍。确认无误后点 Install正式开始安装。3.4 安装过程耐心是唯一的技巧点击 Install 之后就是漫长的等待。安装时间取决于你的硬盘速度和勾选的器件数量固态硬盘大概 30 分钟到 1 小时机械硬盘可能两小时以上。安装过程中进度条会显示当前在装什么组件。中间可能会弹出几次驱动安装的确认窗口尤其是装 cable driver 的时候点“安装”或“允许”就行。有几个地方容易出问题进度条长时间不动先别急着强制关闭。Vivado 安装某些大组件时进度条会卡住十几分钟其实后台在解压。可以打开任务管理器看看磁盘和 CPU 有没有活动有活动就继续等。弹出“文件正在使用”错误通常是杀毒软件在扫描。临时关闭杀毒软件后点“重试”。安装到一半蓝屏或断电这是最麻烦的。Vivado 安装不是事务性的中断后可能留下不完整的文件。稳妥做法是卸载重装别想着“继续安装”。安装完成后会提示你是否安装成功以及是否现在启动 Vivado。第一次启动会比较慢因为要初始化一些配置。4. License 处理与首次启动配置4.1 WebPACK 用户基本不用管 License如果你装的是 WebPACK 版本而且用的器件在免费范围内那 License 这块基本不用操心。Vivado 启动后会自动使用内置的免费 License直接能用。但要注意WebPACK 的免费范围是有限的。如果你在工程里选了超出免费范围的器件综合的时候会报 License 错误。这时候要么换器件要么去申请对应的 License。4.2 需要 License 的情况怎么处理如果你用的是 Design Edition 或 System Edition或者 WebPACK 覆盖不到的器件就需要获取 License 文件。正规流程是登录 AMD/Xilinx 官网在 License 管理页面申请。一般有几种类型Evaluation License评估版免费但有时间限制通常 30 到 60 天适合短期试用。Node-Locked License绑定到特定机器需要提供网卡 MAC 地址。公司或学校采购的通常是这种。Floating License浮动 License放在服务器上局域网内多台机器共享。申请到 License 文件通常是.lic后缀后在 Vivado 里通过Help - Manage License加载。加载成功后在Help - About里能看到 License 状态。注意License 和网卡 MAC 绑定换网卡或者用虚拟机导致 MAC 变化License 就会失效。虚拟机里装 Vivado 的话最好把网卡 MAC 固定下来。4.3 首次启动后的必做检查Vivado 第一次启动后别急着建工程先做几个检查确认环境正常。检查一版本信息。在启动界面或者Help - About里确认版本号是 2019.2别装了半天装成别的版本。检查二器件是否可用。新建一个工程走到器件选择那一步看看你需要的器件型号在不在列表里。如果不在说明安装时没勾选对应的器件库需要重新运行安装程序添加。检查三下载器驱动。把下载器比如 Platform Cable USB 或者 Digilent 的下载器插上电脑打开设备管理器看看有没有识别到。Xilinx 的下载器通常显示在“Xilinx Cable”或者“USB Serial Converter”下面。如果显示黄色感叹号说明驱动没装好需要手动装一下。检查四SDK 能否启动。如果装了 SDK从 Vivado 里File - Launch SDK试试能不能打开。Zynq 开发离不开 SDK这一步确认好后面省事。5. 常见安装问题与排查速查5.1 安装阶段典型报错报错现象可能原因解决办法安装程序双击没反应权限不足或杀毒拦截右键管理员运行关闭杀毒解压报“文件损坏”下载不完整或压缩工具问题校验哈希值换 7-Zip 解压安装中途卡死磁盘慢或后台扫描等待关闭杀毒检查磁盘活动提示路径含非法字符中文或空格路径换纯英文无空格路径驱动安装失败系统策略或权限手动到驱动目录安装安装完成但器件缺失器件库没勾选重新运行安装程序添加器件5.2 安装后使用中的高频问题问题一综合时报 “Part not supported”。这是器件不在当前 License 或安装范围内。检查两点器件库是否装了License 是否覆盖该器件。问题二下载器识别不到。先换 USB 口再换线然后检查设备管理器。Windows 10 有时候会自动装一个不匹配的驱动需要手动更新为 Xilinx 的驱动。驱动文件一般在安装目录的data\xicom\cable_drivers下面。问题三Vivado 启动特别慢。第一次启动慢是正常的。如果每次都慢检查是不是装在机械硬盘上或者内存不足导致频繁读盘。另外关闭不必要的后台程序也有帮助。问题四界面字体模糊或乱码。这通常是系统缩放或者区域设置的问题。把系统显示缩放调到 100% 试试或者检查区域语言设置。问题五工程从别的版本迁移过来报错。Vivado 不同版本之间的工程兼容性有限。2019.2 打开更高版本创建的工程基本会失败。解决办法是用对应版本打开或者让工程创建者导出为 2019.2 兼容格式。5.3 几个我踩过的坑和独家心得坑一装在移动硬盘上。我曾经图省事把 Vivado 装在移动硬盘里想着换电脑方便。结果 USB 接口速度不稳定综合的时候经常报 I/O 错误工程文件损坏过两次。后来老老实实装在内置固态硬盘上再没出过问题。坑二同时装多个版本没隔离。一台机器上装多个 Vivado 版本是可以的但要注意安装路径要区分开比如D:\Xilinx\Vivado\2019.2和D:\Xilinx\Vivado\2020.2。另外环境变量和 License 有时候会冲突启动时注意选对版本。坑三忽略安装日志。Vivado 安装过程会生成日志文件一般在临时目录或者安装目录下。安装失败时日志里往往有详细原因比界面上那句“安装失败”有用得多。学会看日志排查效率翻倍。坑四用中文用户名。Windows 用户名如果是中文Vivado 有些临时文件路径会出问题。建议要么用英文用户名要么把临时目录改到英文路径下。坑五不备份安装包。安装包下载一次不容易装完之后别急着删。我习惯把安装包和 License 文件一起放在一个专门的文件夹里换电脑或者重装系统的时候直接拿来用省得重新下载。6. 安装完成后的环境优化建议6.1 让 Vivado 跑得更顺的几个设置装好只是第一步稍微调几个设置日常使用体验会好很多。调整综合和实现的线程数。Vivado 默认会用所有可用的 CPU 核心但有时候线程太多反而因为内存争抢导致变慢。在Tools - Settings - Synthesis和Implementation里可以手动指定线程数。一般设成物理核心数就行比如 8 核 CPU 设 8。设置临时目录到固态硬盘。Vivado 综合和实现过程中会产生大量临时文件默认放在系统临时目录。如果系统盘是机械硬盘把临时目录改到固态硬盘上速度提升明显。在Tools - Settings - General里可以改。关闭不必要的自动功能。比如自动检查更新、自动加载最近工程等这些功能会拖慢启动速度。在设置里关掉启动能快几秒。6.2 工程目录的组织习惯我见过太多人把工程建在桌面或者下载文件夹里时间一长乱成一锅粥。建议养成固定的目录结构D:\FPGA_Projects\ ├── 01_LED_Test\ ├── 02_UART\ ├── 03_DDR3\ └── ...每个工程一个独立文件夹工程内部 Vivado 会自动生成project_name.srcs、project_name.runs等目录不要手动去改这些目录里的文件。工程相关的文档、约束文件、测试脚本可以单独放在工程根目录下的doc、constraints、sim等文件夹里结构清晰以后回头看也方便。6.3 版本管理与备份FPGA 工程不像软件代码那样容易做版本管理但也不是没办法。Vivado 工程里真正需要版本管理的是源码文件.v、.sv、.vhd、约束文件.xdc、IP 配置文件.xci和脚本.tcl。生成的中间文件和比特流不用管。我习惯用 Git 管理源码和约束工程文件本身不纳入版本管理需要的时候用 Tcl 脚本重建工程。这样仓库体积小迁移也方便。提示Vivado 支持通过 Tcl 脚本导出和重建工程。在File - Project - Write Tcl可以导出重建脚本配合源码一起管理是很实用的工程迁移方案。7. 关于安装包和版本选择的一点个人看法写到这里安装流程基本讲完了。最后聊几句关于安装包和版本选择的个人体会。很多人纠结“到底装哪个版本”。我的观点是跟着你的板子和项目走别盲目追新。如果你的板子是学校发的或者公司指定的先问清楚他们用的什么版本保持一致最省事。如果是自己玩2019.2 是个很稳妥的选择资料多、坑少、对硬件要求相对低。至于安装包能走官方渠道就走官方渠道。网上的整合包虽然方便但来源不明万一被塞了东西损失的是自己。下载的时候耐心一点校验一下哈希值这点时间花得值。还有一点装完之后把安装包和 License 文件归档保存。我见过太多人重装系统后找不到安装包又得重新下载浪费一整天。花几分钟整理归档以后能省很多事。FPGA 这条路工具安装只是第一步后面还有综合、实现、时序约束、板级调试一大堆东西要学。但第一步走稳了后面会顺很多。希望这篇东西能帮你把 Vivado 2019.2 顺利装起来少走点弯路。