📚 课程目录第3章版本标识与命名规范设计

3. 版本标识与命名规范设计

在 Studio 5000 项目中，版本标识不是“给文件起个好看的名字”，而是一套贯穿控制器固件、ACD 工程文件、L5X 导出文件、变更记录与归档目录的标识体系。它要回答三个问题：这份工程处于什么成熟度？它对应哪一次变更？出了问题该找谁？如果这三个问题在文件名和版本号里就能读出答案，版本治理的成本会大幅下降。

一、三段式版本号：主版本.次版本.修订号

推荐采用 主版本.次版本.修订号 三段式语义化版本，例如 V2.3.7。三段数字各自承担不同的语义，不能随意递增：

主版本（Major）：发生不兼容变更时递增。典型场景包括控制器平台更换（如 CompactLogix 5380 换为 ControlLogix 5580）、I/O 组态结构重构、AOI 接口参数增删、通信协议由 EtherNet/IP 改为其他方式。主版本变化意味着下游程序、HMI 标签映射或上位系统可能需要同步改造。
次版本（Minor）：发生向后兼容的功能新增时递增。例如新增一段工位逻辑、增加一个报警分支、扩展配方数量，但原有标签、AOI 接口和数据结构保持兼容。次版本变化通常只需回归测试新增部分。
修订号（Patch）：仅做缺陷修复、注释补充、参数微调且不改变功能范围时递增。例如修正一个定时器预设值、修复一个互锁条件、更新中文注释。

需要特别说明：Studio 5000 的 ACD 文件本身带有“工程修订”属性，但它与我们的三段式版本号不是一回事。ACD 内部修订是软件自动累加的保存次数，而三段式版本号是人为定义的“对外发布标识”。建议在控制器属性、工程说明或专门的版本标签中记录三段式版本号，使两者并存而不混淆。

二、文件命名约定

文件命名应把“项目、区域、设备、版本、日期、责任人”压缩进一个可排序、可检索的字符串。推荐格式如下：

项目代号_区域_设备_版本号_YYYYMMDD_责任人缩写.acd
示例：MX7_LINE2_STN03_V2.3.7_20250612_ZHJ.acd

各字段含义与约束：

项目代号：2～6 位大写字母或数字，如 MX7，避免使用中文和空格。
区域：产线或工段标识，如 LINE2、PKG、UTIL。
设备：工位或设备编号，如 STN03、ROB01、CNV05。
版本号：三段式版本，前缀 V，如 V2.3.7。
日期：8 位 YYYYMMDD，保证按名称排序即按时间排序。
责任人缩写：2～4 位拼音或英文缩写，如 ZHJ，与变更记录中的责任人一致。

L5X 导出文件、变更说明、备份压缩包沿用同一命名主干，仅扩展名或后缀不同，例如 MX7_LINE2_STN03_V2.3.7_20250612_ZHJ.l5x、MX7_LINE2_STN03_V2.3.7_20250612_ZHJ_变更说明.docx。这样在资源管理器中按名称排序，同一设备的历史版本会自然聚在一起。

命名中不要出现“最终版”“最新”“修改后”等词。这些词无法排序、无法追溯，也无法判断谁改的。版本号和日期已经承担了“最新”的表达职责。

三、日期与责任人标识

日期统一使用 YYYYMMDD，不使用 2025.6.12 或 06/12/25，避免跨区域协作时产生月日歧义。责任人标识建议在团队内维护一张缩写对照表，例如 ZHJ=张宏杰、LQ=李强、WXY=王小雨，并写入变更记录模板的固定字段。

责任人标识不仅出现在文件名中，还应出现在三个位置：ACD 工程属性的“作者/说明”字段、变更记录表的“修改人”列、以及控制器版本标签（若项目使用自定义标签记录版本）。三处一致，才能在审计或排障时快速定位变更来源。

四、多工作站项目命名方案实战

假设某汽车零部件焊装线项目代号 WELD9，包含三个工作站：STN01 点焊、STN02 涂胶、STN03 检测。当前 STN01 已完成 V1.0.0 首次发布，随后新增了车型配方切换功能（次版本），又修复了一个夹具互锁缺陷（修订号），当前版本为 V1.2.1。责任人张宏杰，发布日期 2025 年 6 月 12 日。

按上述规则，STN01 的发布文件命名为：

WELD9_STN01_STN01_V1.2.1_20250612_ZHJ.acd
WELD9_STN01_STN01_V1.2.1_20250612_ZHJ.l5x
WELD9_STN01_STN01_V1.2.1_20250612_ZHJ_变更说明.docx

STN02 与 STN03 若尚未同步到 V1.2.1，则保留各自当前版本号，例如 STN02 为 WELD9_STN02_STN02_V1.1.0_20250520_LQ.acd。这样在归档目录中，三个工作站的版本状态一目了然，不会因为“统一改名”而掩盖实际差异。

下面用一张关系图展示版本号递增规则、命名字段构成以及多工作站版本状态之间的关系，便于在制定规范时对照检查。

从图中可以看出，版本号规则、命名字段、责任人标识和归档目录是相互咬合的：版本号决定文件名的核心字段，命名决定归档时的排序与检索，责任人标识保证三处可追溯，而多工作站各自保留真实版本状态，避免“一刀切”改名造成信息失真。

五、落地检查要点

制定规范后，建议在项目启动会上确认以下事项：团队缩写对照表是否建立；ACD 工程属性中的作者字段是否填写；变更记录模板是否包含版本号、日期、责任人、变更类型（主/次/修订）四列；归档目录是否按“项目/设备/版本”三级组织；L5X 导出是否与 ACD 同版本号同步导出。只要这五项在第一次发布时就执行到位，后续每次变更都会自然沿用同一套标识，版本治理就从“靠记忆”变成了“靠规则”。