2、Vivado工程创建与项目管理
好，咱们正式开始动手了。这一章我带你走一遍Vivado工程从无到有的全过程。说实话，很多新手拿到Vivado第一反应就是「点Next就完事了」，结果做到一半发现器件选错了、目录乱成一锅粥、版本管理更是无从下手。嗯，这些坑我都踩过，今天一次性帮你填平。
2.1 创建Vivado工程——别急着点Next
打开Vivado，你会看到那个熟悉的欢迎界面。点「Create Project」，然后弹出一个向导。这里我要多说一句：工程名字和路径，决定了你未来三个月的心情。
命名规范建议：
- 工程名：
rv32_core_v1_0（项目名_版本号） - 路径：
D:/projects/rv32_core/（不要有中文、空格、特殊字符） - 顶层模块名：
top_rv32（与工程名区分开）
我个人习惯在工程名里带上版本号。为什么？因为Vivado工程一旦生成，里面会缓存大量中间文件。如果你要回退到某个旧版本，光靠工程名根本分不清。我吃过这个亏——有一次为了赶进度，连续改了三天，最后分不清哪个工程是能用的，只能一个个打开试。
选「RTL Project」就行，别勾「Do not specify sources at this time」。除非你只是想看看器件资源，否则老老实实把源文件加进来。
2.2 选择器件与开发板——别选错了，否则白干
这一步是新手最容易翻车的地方。Vivado支持两种方式：按器件选，或者按开发板选。
| 方式 | 适用场景 | 注意事项 |
|---|---|---|
| 按器件选 | 自己画板子、定制PCB | 必须确认封装、速度等级完全一致 |
| 按开发板选 | 使用官方或第三方开发板 | Vivado内置的板级文件可能不全，需要手动导入 |
如果你用的是Nexys A7、Basys 3这类常见板子，直接选开发板型号就行。但如果你用的是国产开发板，比如某宝上买的「Artix-7核心板」，Vivado里大概率找不到。这时候你得手动选器件——比如XC7A35T-1CSG324C。注意那个「-1」是速度等级，别选成「-2」或「-3」，否则时序分析结果会有偏差。
我曾经踩过的坑：有一次我选错了封装，把CSG324选成了FTG256。结果综合布线全通过，但下载时死活连不上芯片。查了两天才发现是引脚不匹配。嗯，从那以后我每次选器件都要对着芯片丝印核对三遍。
2.3 工程目录结构解析——别让文件乱飞
Vivado默认生成的目录结构其实挺乱的。我个人习惯在创建工程之前，先手动建好一套目录骨架。你想想看，一个RISC-V处理器工程，少说也有几十个源文件、几百个IP核、上千个约束文件。如果全堆在根目录下，找文件就像大海捞针。
下面是我用了多年的目录结构，你可以直接照搬：
rv32_core/
├── src/ # RTL源文件
│ ├── rtl/ # 自己写的Verilog/VHDL
│ ├── ip/ # IP核文件（.xci）
│ └── sim/ # 仿真文件
├── constrs/ # 约束文件
│ ├── timing.xdc # 时序约束
│ └── pin.xdc # 引脚约束
├── scripts/ # Tcl脚本
│ ├── build.tcl # 自动构建脚本
│ └── debug.tcl # 调试脚本
├── docs/ # 文档
│ └── design_spec.pdf
├── vivado_project/ # Vivado工程目录
│ └── rv32_core.xpr # 工程文件
└── README.md # 工程说明
为什么要把源文件和工程目录分开？因为Vivado的工程文件里有很多自动生成的缓存，比如.jou、.log、.str这些。如果你用Git管理，这些文件每次打开工程都会变，提交起来非常烦人。分开之后，你只需要把src/、constrs/、scripts/这些核心目录纳入版本管理就行。
小技巧：在Vivado里添加源文件时，尽量用「Add Directory」而不是「Add Files」。这样如果以后新增文件，Vivado会自动识别，不用手动一个个加。
2.4 版本管理建议——别让代码丢了
说到版本管理，我见过太多人直接用Vivado自带的「Archive Project」功能。说实话，那个功能生成的.zip文件动辄几百兆，而且里面塞满了缓存。你想想看，一个RISC-V处理器工程，核心代码可能只有几兆，但打包出来却要几百兆，这合理吗？
我的建议是：用Git，但别把整个Vivado工程塞进去。
具体来说，你需要创建一个.gitignore文件，把下面这些目录和文件忽略掉：
# Vivado自动生成的文件
vivado_project/*.jou
vivado_project/*.log
vivado_project/*.str
vivado_project/.Xil/
vivado_project/vivado_project.runs/
vivado_project/vivado_project.cache/
vivado_project/vivado_project.hw/
# IP核缓存
src/ip/*.xcix
src/ip/*/synth/
src/ip/*/sim/
这样你提交的代码就干净多了。核心的RTL代码、约束文件、Tcl脚本，加起来可能不到10MB。而且每次修改都能清晰地看到diff，不会因为Vivado的缓存文件而混淆视听。
版本管理最佳实践：
- 每次综合或实现之前，先commit一次代码
- 用Tcl脚本记录Vivado的版本号（比如2023.1）
- 在README里写明依赖的IP核版本
- 分支命名：
feature/axi_bridge、bugfix/timing_violation
我曾经接手过一个项目，前任工程师把所有文件都放在一个目录下，没有版本管理，没有注释。我花了整整一周才理清楚哪些文件是有效的。嗯，从那以后我养成了一个习惯：每次新建工程，第一件事就是搭好目录结构和.gitignore。磨刀不误砍柴工，真的。
2.5 本章知识体系
下面这张图帮你梳理了本章的核心逻辑。从创建工程开始，到器件选择、目录搭建、版本管理，每一步都有对应的注意事项。你可以把它当作一个检查清单，每次新建工程时对照着走一遍。
好了，这一章的内容就到这里。你按照上面的步骤走一遍，一个干净、规范、可维护的Vivado工程就搭起来了。下一章咱们开始往工程里添加RISC-V处理器的IP核，到时候你会看到，一个好的工程结构能让你省多少事。
公众号:蓝海资料掘金营，微信deep3321