标题：Vivado 多工程共享远程 IP 缓存实操，减少重复生成、大幅节省编译时间
Vivado 默认 IP 缓存是本地工程私有，每新建一个工程，哪怕 IP 参数、器件完全一致，都会重新跑一遍 IP 生成、OOC 综合，编译耗时大量浪费，远程 IP 缓存就是把缓存目录单独抽出来，多个 Vivado 工程、甚至多名开发共用同一个缓存池；只要 IP 型号、配置参数、目标器件没有改动，工具直接读取已经生成好的结果，界面提示 Using cached IP results，跳过整套重生成流程，同时还能减少磁盘重复占用。它和普通 IP 仓库不是一回事，IP Repository 存放的是 IP 源码、打包文件，远程 IP Cache 存放的是已经综合、输出好的产物，靠哈希值匹配每一组 IP 配置，只要哈希命中就复用。整套方案支持图形界面单点配置，也能用 TCL 脚本全局默认开启，适合版本分支多、工程数量大、大量复用相同 IP 的 FPGA 项目，下面把目录规划、界面配置、脚本配置、校验方法、踩坑点完整整理出来。
一、本地缓存和远程 IP 缓存对比
| 项目 | Local（本地缓存，默认） | Remote（远程共享缓存） |
|---|---|---|
| 存储位置 | 放在工程目录内部，跟着工程走 | 独立目录，脱离任意单个工程 |
| 多工程共享 | 不支持，每个工程独立生成 | 多个工程指向同一路径，共享产物 |
| 触发重生成 | 复制工程、新建工程都会重新生成 IP | 参数、器件不变直接命中缓存 |
| 适用场景 | 独立小型工程、临时验证 | 多分支、多版本、团队协同、大批量复用 IP |
| 清理方式 | 删除工程直接带走缓存 | 需要单独维护清理，体积持续上涨 |
二、推荐目录结构
建议分开 IP 仓库和缓存目录，不要混在一块，减少扫描卡顿：
fpga_shared/
├── ip_repo IP 源码仓库（打包好的自定义 IP）
└── ip_cache 远程共享 IP 缓存目录
单独给 ip_cache 目录，不要直接把缓存指向文件很多的大目录，Vivado 启动时会扫描目录，杂文件多会拖慢打开工程速度。
三、图形界面单工程配置步骤
- 打开 Vivado 工程，进入 Settings → IP → IP Cache。
- Cache scope 从 Local 修改为 Remote。
- Cache location 浏览选中提前建好的共享 ip_cache 文件夹。
- 确认生成选项：生成 BD 的时候，选择 Out of context per IP（按 IP 单独 OOC），这是缓存生效的必要条件。
- 执行 Generate Output Products，首次运行会生成 IP 并写入缓存，目录内以哈希文件夹存储每一组 IP 配置。
- 新建第二个工程，同样把 IP Cache 指向这个共享路径，添加一模一样配置、相同器件的 IP，再次生成就会命中缓存，不再重新综合。
四、TCL 配置方式（适合自动化、全局默认）
单工程脚本，打开工程后执行：
config_ip_cache -remote [file normalize "/fpga_shared/ip_cache"]
全局默认方案，修改 Vivado_init.tcl，新建工程自动走远程缓存，不用每次手动点设置：
Linux
set_param project.defaultIPCacheSetting /fpga_shared/ip_cache
Windows
set_param project.defaultIPCacheSetting D:/fpga_shared/ip_cache
如果需要关闭全局缓存，设置为 none：
set_param project.defaultIPCacheSetting none
还可以用命令查看缓存内容、打包缓存：
config_ip_cache -list_cache
config_ip_cache -zip_cache
五、缓存命中判定规则
- ✅ 命中条件：IP 类型、所有配置参数、目标器件型号、速度等级完全一致，哈希匹配成功。
- ❌ 不会命中：哪怕只修改一个参数、换芯片型号，都会生成一条全新缓存条目。
- 哈希键：Vivado 自动计算，用户不用手动维护。
- 跨版本提醒：大版本 Vivado（2020.1 / 2022.1）之间缓存不能互通，建议按版本分开缓存目录。
六、日常运维清单
- 按 Vivado 版本拆分缓存目录，不同工具版本不要混用。
- 网络共享盘场景：给所有开发账号读写权限，多人协同。
- 定期清理：缓存体积增长很快，可以用 -zip_cache 归档不常用条目，或者定期删除老旧哈希目录。
- 版本管理：ip_cache 一般不放进 Git，只共享路径，不提交缓存文件。
- 备份：重要项目可以单独导出命中的缓存包，离线环境导入。
七、高频踩坑点
- 生成方式不是 OOC per IP：选全局综合或者按 Block Design OOC，缓存不会生效。
- 缓存目录混杂大量无关文件：工具扫描耗时明显增加，打开工程变慢。
- 跨 Vivado 版本共用缓存：大概率失效，报 IP 生成错误。
- Windows/Linux 路径混用：分隔符、权限问题导致无法写入缓存。
- IP 仓库和缓存目录混淆：repo 放源码，cache 放生成产物，二者作用完全不同。
- 权限不足：网络盘共享场景，账号没有写权限，无法写入新缓存。
八、收益边界
✅ 收益
- 重复 IP 直接跳过综合，编译时间大幅压缩，多分支工程收益最明显。
- 磁盘空间节省，同一份 IP 产物只存一份。
- 团队协作场景，一个人生成，其他人直接复用。
⚠️ 局限
- IP 参数、器件一变，就会新增缓存条目，不会复用旧版本。
- 不能替代版本管理，IP 源码改动依旧需要重新生成。
- 共享盘带宽低的时候，读取缓存反而比本地缓存慢。
【相关 FAQ】
问题 1：Vivado 远程 IP 缓存和 IP Repository 的区别是什么，在多工程复用里分别起什么作用？
回答 1：IP Repository 存放 IP 源码、打包后的 IP 源文件，用来在 IP 目录里加载 IP；远程 IP 缓存存放 IP 已经生成、OOC 综合完成的输出产物，多工程复用远程 IP 缓存，是跳过重复生成步骤，二者搭配使用才能完整提速。
问题 2：Vivado 设置远程 IP 缓存之后，满足什么条件才能命中缓存、节省编译时间？
回答 2：想要命中 Vivado 远程 IP 缓存，必须保证 IP 型号、全部配置参数、目标器件和速度等级完全一致，并且生成输出产品时选择 Out of context per IP，同时 Vivado 大版本保持一致，哈希匹配成功就不会重新生成 IP。
问题 3：在 Vivado 多工程复用远程 IP 缓存，跨 Vivado 版本可以共用同一个缓存文件夹吗？
回答 3：不建议跨 Vivado 版本共用远程 IP 缓存，不同版本生成的产物格式、哈希规则存在差异，大概率无法命中，甚至出现编译报错，最好按照工具版本单独划分独立的 ip_cache 目录。
问题 4：Vivado 使用远程 IP 缓存，多人在网络盘协同开发，有哪些权限和路径注意事项？
回答 4：网络盘上的 Vivado 远程 IP 缓存目录，所有协同账号都要有读写权限；Windows 和 Linux 不要混用路径，同时不要把缓存目录设置在文件杂乱的文件夹，否则 Vivado 扫描目录会拖慢工程打开速度。
【参考资料】
[2026-02-18]（节省编译时间系列（四）：在多个 Vivado 工程间复用远程 IP 缓存）电子工程专辑
[2025-09-01]（Vivado UG896 IP 用户指南：IP Cache 配置）AMD 官方文档
[2025-06-12]（Vivado config_ip_cache TCL 命令参考）AMD
[2024-11-20]（Vivado 共享远程 IP Cache 团队协同最佳实践）FPGA 技术江湖
[2024-05-08]（Vivado IP Integrator OOC 综合与缓存原理）AMD 中文技术简报
【免责声明】
本文基于 AMD Vivado 官方文档与公开 FPGA 工程实践整理；远程 IP 缓存命中效果受 IP 参数、器件、Vivado 版本、存储介质带宽影响；网络共享缓存存在权限、同步、性能风险，上线团队协同前建议在对应版本单独验证；内容仅为工程提速教程，不替代官方手册。