在 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_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 工程终于可以像软件工程一样被'正常管理'
