Vivado卸载核心要点：保留工程数据的同时清理工具链-平芜编程栈

如何安全卸载 Vivado：保留工程数据，彻底清理工具链

你有没有过这样的经历？
想升级到新版 Vivado，或者重装系统前清理旧环境，结果一通操作下来——
项目打不开了，IP 丢了，甚至新版本启动报错……

问题出在哪？
不是 Vivado 不好用，而是很多人在“卸载”这件事上栽了跟头。

Vivado 并不像普通软件那样点个“卸载”就万事大吉。它是个庞然大物，安装包动辄几十 GB，涉及注册表、环境变量、驱动服务、缓存文件……稍有不慎，轻则残留混乱，重则误删项目，血泪教训不少。

但更关键的是：我们真正要删的，是工具本身；而必须保住的，是我们辛辛苦苦做的工程。

本文不讲大道理，只给你一套可落地、零风险、适用于所有版本（2018~2024）的 Vivado 卸载实战指南。
目标明确：
✅ 彻底清除工具链
✅ 完整保留所有工程源码与配置
✅ 避免影响后续新版本安装

工具和工程，天生就该分开

先搞清楚一件事：Vivado 的安装目录 ≠ 你的工程文件夹。

理想状态下，它们应该是两个独立的存在：

类型	内容示例	是否可删
工具链（Toolchain）	`bin/`,`data/`,`uninstall.exe`, 综合器、仿真器等	✅ 可安全删除
用户工程（Projects）	`.xpr`文件、`.xdc`约束、HDL 源码、Block Design	❌ 必须保留

📌 核心原则：只要你的工程不在C:\Xilinx\Vivado\...这类路径下，就可以放心卸载工具。

但现实中，很多初学者图方便，直接在 Vivado 安装目录里创建工程，比如：

C:\Xilinx\Vivado\2023.1\my_uart_project\

这种做法等于把“家当”放在了“工地”上。一旦拆“工地”，家也没了。

所以第一步，不是急着卸载，而是——
确认你的工程到底住哪儿。

第一步：审计所有工程路径（别跳过！）

打开 Vivado，进入 Tcl Console，运行这行命令：

foreach prj [get_projects] { set name [get_property NAME $prj] set dir [get_property DIRECTORY $prj] puts "📌 $name → $dir" }

输出会类似这样：

📌 uart_demo → D:/FPGA_Projects/uart_demo 📌 camera_ctrl → C:/Xilinx/Vivado/2023.1/camera_ctrl

看到第二个了吗？
camera_ctrl居然建在了安装目录里！这就是典型高危项目。

🔧 应对策略：立即迁移！

别犹豫，现在就把这些“寄生”工程搬出去：

关闭 Vivado；
复制整个工程文件夹到安全位置，例如E:\Archived_Projects\camera_ctrl；
重新打开 Vivado，使用File > Open Project打开迁移后的.xpr文件；
如果能正常加载设计、网表、IP，说明迁移成功。

⚠️ 注意：不要只复制源码，一定要复制整个工程文件夹（包含.runs,.ip_user_files等）。虽然中间文件可以重建，但 IP 配置、引脚约束等信息都在里面。

迁移完成后，原路径下的工程就可以视为“已解放”，不再受工具卸载波及。

第二步：用官方卸载程序，别手贱删文件夹！

很多人图快，直接右键删除C:\Xilinx\Vivado\2023.1整个目录。
这是最危险的操作之一。

为什么？

因为 Vivado 在安装时做了这些事：
- 向 Windows 注册表写入组件信息
- 安装 USB JTAG 驱动（如 Digilent、Xilinx Platform Cable）
- 添加系统服务（如硬件管理器后台进程）
- 修改环境变量（PATH、XILINX_VIVADO）

如果你只是删文件夹，这些残留项一个都不会消失。后果可能是：
- 新版 Vivado 启动失败
- 命令行仍能找到旧vivado.bat
- JTAG 设备识别异常
- 许可证管理器冲突

✅ 正确做法：运行官方卸载程序

找到这个路径：

Windows:
C:\Xilinx\Vivado\2023.1\.xinstall\uninstall.exe
（注意.xinstall是隐藏文件夹，需开启“显示隐藏项目”）
Linux:
/opt/Xilinx/Vivado/2023.1/.xinstall/uninstall

双击运行，选择图形化或命令行模式均可。推荐使用 GUI 模式，全程可视化，避免误操作。

💡 小技巧：支持静默卸载，适合批量维护机器
bash ./uninstall --mode unattended

等待几分钟，工具链会被完整移除。

第三步：手动收尾——清理残余配置

即使用了官方卸载，也别以为万事大吉。系统层面还有几处“暗桩”需要手动拔掉。

1. 清理环境变量（关键！）

按下Win + R，输入sysdm.cpl→ 高级 → 环境变量。

检查以下变量是否还存在，若有，请删除：

变量名	示例值	说明
`XILINX_VIVADO`	`C:\Xilinx\Vivado\2023.1`	必清，否则可能调用旧工具
`PATH`中的 Vivado 路径	`%XILINX_VIVADO%\bin`	删除该项，防止命令冲突
`LM_LICENSE_FILE`	`2100@lic-server`	若换许可证服务器，需更新
`XILINX_LOCAL_USER_DATA`	`%APPDATA%\Xilinx`	可选清除，影响 GUI 设置

📝 Linux 用户注意：检查~/.bashrc,~/.zshrc或/etc/profile.d/xilinx.sh是否 sourced 了旧版settings64.sh，记得注释掉。

2. 删除临时与缓存目录（可选但推荐）

这些目录不包含工程源码，但可能占用数 GB 空间：

Windows:
%APPDATA%\Xilinx（GUI 配置）
%LOCALAPPDATA%\Xilinx（本地缓存）
C:\Users\你的用户名\AppData\Roaming\Xilinx
Linux:
~/.Xilinx/
~/.cache/Xilinx/

✅ 提示：这些目录里的内容都可以重建，删了不影响未来使用新版本。

3. 卸载 JTAG 驱动（如有必要）

如果之前连接过 FPGA 开发板，系统可能仍加载了 Xilinx USB 驱动。

前往控制面板 → 程序和功能，查找并卸载：
- Xilinx Cable Drivers
- Digilent Adept Runtime（若使用 Digilent 板卡）

然后重新插拔设备，系统会自动安装新版驱动（当你安装新 Vivado 时）。

第四步：验证卸载成果

做完以上步骤，来验证一下是否真的“干干净净”：

打开 CMD 或 PowerShell，输入：
cmd vivado -version
应提示'vivado' 不是内部或外部命令。
搜索电脑中是否还有vivado.exe：
- 在文件资源管理器搜索框输入vivado.exe
- 查看返回结果路径，确保无2023.1相关条目
尝试打开一个旧工程：
- 启动新版 Vivado
- 使用Open Project打开你迁移过的.xpr文件
- 观察是否能正常加载 IP、约束、布局布线结果

全部通过？恭喜，你已经完成了一次专业级的工具链清理。

实战建议：建立规范开发结构

为了避免下次再踩坑，强烈建议你从现在开始养成以下习惯：

🗂 目录结构模板（推荐）

D:\FPGA_Workspace/ ├── Projects/ # 所有工程集中管理 │ ├── uart_controller/ │ └── ddr_memory_test/ ├── IPs/ # 共享 IP 核库（可版本控制） ├── Archives/ # 归档已完成项目 └── Scripts/ # Tcl/Python 自动化脚本

永远不要把工程放在 C 盘或工具目录下！

🔄 版本控制加持

将工程纳入 Git 管理：

git init git add .xpr .srcs .sim .xdc git commit -m "Initial commit"

好处：
- 防丢失：云端备份，不怕硬盘坏
- 易迁移：换电脑也能一键恢复
- 可追溯：每次修改都有记录

⚠️ 注意：.runs,.cache等生成目录应加入.gitignore

常见问题与避坑指南

问题现象	原因	解决方案
卸载后桌面还有 Vivado 快捷方式	卸载程序未清理图标缓存	手动删除快捷方式
新版 Vivado 启动时报 license 错误	旧环境变量干扰	清理`LM_LICENSE_FILE`和`XILINX_VIVADO`
打开工程提示 “IP not found”	IP 缓存路径错误	在 IP Catalog 中重新定位或重建
JTAG 无法识别开发板	驱动未更新	重新安装 Xilinx Cable Driver
Tcl 脚本路径报错	脚本硬编码旧路径	使用相对路径或变量替换