跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言

Vivado 工程 Git 版本管理实战指南

Vivado 2022.1 起源文件与生成文件分离,便于 Git 管理。核心操作为提交 .srcs 目录与 .xpr 文件,无需提交 .gen 目录。通过 git init、add、commit 及 push 可完成版本控制,clone 后可直接打开 .xpr 重建工程。流程无需额外脚本,适合 FPGA 开发协作。

ApiHolic发布于 2026/4/9更新于 2026/9/989 浏览

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

目录

  1. Vivado 2022.1 之后最重要的变化:源文件与生成文件分离
  2. 示例工程说明
  3. Vivado 工程目录结构解析
  4. 1. .srcs 目录
  5. 2. .gen 目录
  6. 将 Vivado 工程加入 Git 仓库
  7. 初始化仓库
  8. 添加 Vivado 工程文件
  9. 提交到本地仓库
  10. 绑定远程仓库并推送
  11. 从 Git 仓库重建 Vivado 工程
  12. 小结

更多推荐文章

查看全部
  • VS Code 远程 SSH 环境下 Copilot 无法使用 Claude 模型
  • OpenClaw 框架更新:支持 GPT-5.4、记忆热插拔与插件化上下文引擎
  • AI × 低代码 × 工程化:Oinone Pamirs 的下一代产品化引擎实践
  • Dify 入门:从 Web 到 API 的交付与集成方案
  • GitHub Copilot 兼容 API 方案:copilot-api 使用指南
  • 动态规划:01 背包问题详解
  • 快速排序原理与实现详解
  • MCP 模型上下文协议详解:架构、原理与应用
  • Ubuntu 22.04 安装 NVIDIA RTX PRO 6000 Blackwell 驱动指南
  • 结合 Whisper 与 pyannote.audio 实现说话人分离转写系统
  • Windows 平台零基础部署 Qwen1.5 大模型教程
  • Stable Diffusion 3.5 高效运行:FP8 参数调优与部署教程
  • Flutter for OpenHarmony 实战:通义万相 AIGC 联调与相册持久化
  • 基于 OpenClaw 和 Ollama 搭建本地 AI 智能体教程
  • 微服务容器化与云原生部署:Docker + Kubernetes 实战
  • SpringBoot + Vue 前后端分离项目实战:权限、工作流与报表
  • ImGui:从零开始构建 C++ GUI 界面
  • 基于 YOLO26 深度学习的无人机视角车辆旋转框检测系统
  • 基于 FPGA 的千兆网 GigE Vision 视频传输方案实现
  • 零基础网络安全入门指南:学习路线与实战建议

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online