3、版本控制基础概念：Git核心原理、仓库、提交、分支、标签的概念

在SPICE器件建模的工程环境中，模型文件（.lib、.mdl、.subckt）会经历数十甚至上百次迭代。版本控制的核心目标就是记录每一次变更、支持并行开发、实现精准回溯。Git作为当前最主流的分布式版本控制系统，其核心原理与概念是构建模型库管理流程的基石。

3.1 Git核心原理：快照与哈希链

Git与其他传统版本控制工具（如SVN）最本质的区别在于其数据存储模型。SVN记录的是文件差异（Delta），而Git记录的是整个项目的快照（Snapshot）。

• 快照存储：每次提交（Commit）时，Git会保存所有文件在那一刻的完整状态指针。如果文件没有变化，Git不会重复存储文件内容，而是链接到之前已存储的相同文件。
• 哈希寻址：每个快照（提交对象）都有一个唯一的SHA-1哈希值（如 a1b2c3d4...），作为该提交的身份证。哈希值由文件内容、目录结构、提交信息、父提交哈希等元数据计算得出，保证了数据的完整性。
• 不可变性：一旦生成，提交对象的内容不可更改。任何修改都会产生一个新的哈希值，从而形成一条不可篡改的提交链。

3.2 仓库（Repository）

仓库是Git管理项目的基本单位，本质上是一个存储所有元数据和对象数据库的目录（通常为 .git 文件夹）。在SPICE建模中，一个仓库通常对应一个模型库项目或一个工艺角（Corner）集合。

3.3 提交（Commit）

提交是Git版本控制的核心操作，代表项目在某一时间点的稳定快照。一个高质量的提交应该是一个原子性的逻辑变更。

• 原子性：一个提交只做一件事。例如，“修正NMOS Vth模型参数”是一个原子提交；而“修正NMOS Vth并添加PMOS温度系数”应该拆分为两个提交。
• 提交信息：必须清晰描述“为什么”做这个变更，而不仅仅是“做了什么”。
• 暂存区（Staging Area / Index）：Git独有的概念。在提交前，你需要使用 git add 将修改的文件放入暂存区，然后通过 git commit 将暂存区的内容形成快照。

# 典型的SPICE模型提交流程
git add nmos_model.lib          # 将修改后的NMOS模型文件加入暂存区
git add pmos_model.lib          # 将修改后的PMOS模型文件加入暂存区
git commit -m "fix: 修正NMOS和PMOS的迁移率模型参数，使Id-Vg曲线与硅片测试数据在0.9V-1.2V区间内误差小于2%"

3.4 分支（Branch）

分支是Git最强大的功能之一，它允许你从主开发线上分叉出来，独立进行实验性开发或并行维护，而不会影响主线。在SPICE建模中，分支策略直接决定了模型库的管理效率。

• 主分支（main/master）：通常用于存放经过严格验证、可用于签核（Sign-off）的模型版本。
• 特性分支（feature branch）：用于开发新的模型或优化特定参数。例如 feature/bsim4_self_heating。
• 发布分支（release branch）：用于准备某个版本的发布，只进行Bug修复，不添加新功能。
• 热修复分支（hotfix branch）：用于紧急修复已发布版本中的严重模型错误。

3.5 标签（Tag）

标签是给某个特定的提交打上一个有意义的、静态的名字，通常用于标记发布版本（如 v1.0.0、v2.1.3）。与分支不同，标签创建后不会随着新的提交而移动。

• 轻量标签：只是一个指向特定提交的指针，类似于一个不会移动的分支。
• 附注标签：存储在Git数据库中，包含打标签者的姓名、邮箱、日期和标签信息。推荐使用附注标签，因为它提供了完整的元数据。

# 为SPICE模型库创建附注标签
git tag -a v1.2.0 -m "BSIM4模型库v1.2.0发布：新增自热效应模型，修正了1.1V下的Vth偏移问题"
git push origin v1.2.0