svn管理电子元器件封装库的核心是将其作为可追溯的工程资产，通过trunk/branches/tags标准结构实现版本控制、协作与回退；本地tortoisesvn即可搭建仓库，ad引用trunk路径并配合svn commit/revert保障一致性。

用SVN管理电子元器件封装库，核心是把库文件当作“可追溯的工程资产”来维护，而不是简单地存一堆.pcblib、.schlib文件。它解决的是版本混乱、多人协作冲突、回退困难、更新遗漏这些实际问题。关键不在工具多复杂，而在结构设计和操作习惯。

明确库目录结构与SVN标准分支模型

封装库不是单个文件，而是一套关联资源（原理图符号、PCB封装、3D模型、参数表）。建议按SVN经典三段式组织本地仓库：

• trunk/：主干，存放当前稳定可用的最新版库。AD工程默认引用这里
• branches/：开发分支，比如branches/add_new_connector_series，用于新增器件、修改封装、适配新工艺等，不直接影响生产设计
• tags/：发布快照，如tags/v2026Q2_release，只读，对应嘉立创某次集成库发布或内部评审通过的正式版本

避免把所有库文件平铺在根目录下，否则无法做原子性提交、回滚或差异比对。

建立本地SVN仓库并初始化检出

不需要搭服务器，TortoiseSVN配合本地文件协议即可启动。操作要点：

SVN搭建及使用教学视频(布尔教育)

《SVN视频教程》，SVN:全称Subversion，是代码版本管理软件，管理着随时间改变的数据。这些数据放置在一个中央资料档案库 (repository) 中。这个档案库很像一个普通的文件服务器,不过它会记住每一次文件的变动。这样你就可以把档案恢复到旧的版本, 或是浏览文件的变动历史。许多人会把版本控制系統想像成某种“时光机器”。

下载

• 新建空文件夹，例如 D:\LibRepo\JLCSMT
• 右键 → SVN Create repository here（TortoiseSVN提供该功能）
• 再新建一个工作目录，如 D:\LibRepo\Working，右键 → SVN Checkout，URL填 file:///D:/LibRepo/JLCSMT
• 首次检出后，在Working/trunk里放入嘉立创官方SVN地址提供的初始库（或你已有的规范库），然后右键 → SVN Commit提交到本地仓库

这样就拥有了完整版本历史起点，后续所有增删改都在这个工作拷贝中进行。

日常更新与多人协同的关键动作

封装库迭代不是“覆盖替换”，而是“有据可查的演进”。每次变更都应对应一次有意义的提交：

• 新增一个器件系列？先在branches/建分支，完成验证后再合并到trunk，最后打tags快照
• 修正某个封装焊盘尺寸？修改后提交时日志写明“修正SOT-23-6封装Y轴偏移0.1mm（依据IPC-7351B）”，方便追溯依据
• 同步嘉立创更新？不要直接覆盖，而是SVN Update拉取远程变更，用TortoiseSVN的“Diff with working copy”对比差异，确认无误再提交
• AD软件内引用路径需指向trunk下的具体库文件，而非整个文件夹——避免因路径变动导致工程报错

对接Altium Designer的实际配置

AD本身不内置SVN，但能无缝配合TortoiseSVN工作流：

• 在AD的Preferences → Data Management → Libraries中，Library Path添加为D:\LibRepo\Working\trunk，确保始终调用最新稳定版
• 编辑库时，右键库文件 → SVN Commit，勾选“Include binaries”（.SchLib/.PcbLib是二进制，必须勾选才能正确追踪）
• 若发现库被意外修改，右键 → SVN Revert可一键恢复到上次提交状态，比手动还原快捷可靠
• 团队共用时，可将file://路径换成局域网共享路径，如svn://192.168.1.100/LibRepo（需部署VisualSVN Server）

不复杂但容易忽略