把 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 与源码管理的协同方式。