把 Vivado 项目放心交给 Git：一篇 FPGA 工程师必读的实战指南
之前分享过一篇文章《FPGA 版本管理三种方式：你会选哪一种？》，评论区很多人都推荐使用Git进行版本管理，今天这篇文章主题就是使用Git进行备份指南。
在 FPGA 开发中，掌握 Git 等源码管理工具已经是必备技能。
当然，在使用 Vivado 时，我们不仅需要处理源代码控制，还需要处理以 IP 为中心的设计产品。
Vivado 的工程通常是 IP 为中心 的设计，包含：
- IP Integrator Block Diagram
- 各类 IP 实例（独立 IP 或 BD 内 IP）
- 自动生成的包装文件与工程产物
这让很多 FPGA 工程师一开始会觉得：
“Vivado 项目到底该怎么和 Git 一起用？”
好消息是，从 Vivado 2022.1 开始，这一切已经变得非常清晰、也非常容易。
Vivado 2022.1 之后最重要的变化：源文件与生成文件分离
在 Vivado 2022.1 之前：
源文件和生成文件全部混在同一个 .srcs 目录中。
而从 Vivado 2022.1 起，工程目录被明确拆分为：
- .srcs：源文件
- .gen：生成文件
这一点非常关键。
👉 这意味着：
只要我们保存 .srcs 目录 + .xpr 工程文件，就可以在任何地方完整重建 Vivado 工程。
示例工程说明
示例使用 Vivado 2024.1 创建了一个新工程，目标板卡为 Avnet ZU Board。
IP Integrator 设计包含：
- Zynq MPSoC Processing System
- Smart Interconnect
- AXI BRAM Controller
此外还加入了 自定义 RTL 文件，通过 UART 提供 AXI 访问，用来演示 自定义 RTL 与 IP 设计共存 的情况。
完成后的 Block Diagram 如下：
Vivado 工程目录结构解析
1️⃣ .srcs 目录
imports/ 下是用户添加的 VHDL / Verilog 源文件
bd/ 下是 IP Integrator 的 Block Diagram
ip/ 下是各个 IP 的 .xci 配置文件
👉 这些都是必须纳入 Git 管理的内容
2️⃣ .gen 目录
.gen 中包含：
自动生成的顶层 wrapper
IP 的生成文件
综合与仿真所需的中间文件
👉 这些文件不需要提交到 Git
将 Vivado 工程加入 Git 仓库
假设你已经在 GitHub 上创建了一个空仓库，下面是核心的步骤。
初始化仓库
git init添加 Vivado 工程文件
只需要添加两部分：
git add git_demo.srcs/* git add git_demo.xpr提交到本地仓库
提交这些文件并附带一条消息。
git commit -m "initial issue"你会看到：
.xpr
RTL / VHDL 文件
IP .xci 文件
都已经被 Git 跟踪。
绑定远程仓库并推送
git remote add origin <url> git push -u origin master此时在 GitHub 网页上，就可以看到完整的 Vivado 工程源文件了。
从 Git 仓库重建 Vivado 工程
为了验证流程是否正确，我们新建一个文件夹：
git clone <repo_url>然后直接打开 .xpr 文件。
我们需要重新生成顶层 wrapper，重新生成 IP，正常完成综合与实现即可。
整个流程无需额外脚本，运行非常顺利。
小结
Vivado 2022.1 之后，工程结构已经非常适合 Git 管理
只需管理 .srcs + .xpr
IP、BD、RTL 都能自然融入 Git 流程
Vivado 工程终于可以像软件工程一样被“正常管理”
上面只是简单的使用，后续文章将继续介绍高级点的用法及 Vitis 与源码管理的协同方式。
