1. 课程导入与治理框架

在Omron Sysmac Studio的工程实践中，程序文件往往不是“写完就结束”的静态产物。一个典型的NJ/NX控制器项目，从初版逻辑搭建、现场调试、试运行，到后续的工艺调整、节拍优化、故障修复，程序会经历几十甚至上百次修改。如果没有一套明确的版本与变更治理方法，常见的问题就会反复出现：现场设备上运行的到底是哪一版程序？上周改过的凸轮参数有没有同步到备份？回退时应该回到哪个时间点？两个人同时改同一个POU，谁覆盖了谁？

本课程的目标，不是单纯教大家“多备份几次”，而是建立一套可执行、可追溯、可回退的治理框架，让每一次程序变更都有记录、有依据、有验证、有出口。下面先明确学习目标、核心术语、治理范围和整体路线图。

一、学习目标

完成本课程后，读者应能够：

• 理解版本、变更、基线、发布、回滚在Sysmac工程中的具体含义，而不是停留在抽象概念；
• 为NJ/NX项目建立合理的版本命名与存放结构，区分“工作版”“测试版”“发布版”；
• 在Sysmac Studio中利用工程文件、库文件、控制器在线数据、SD卡备份等手段形成多层保护；
• 对一次具体变更完成“申请—实施—验证—发布—归档”的闭环记录；
• 在出现异常时，能够依据基线快速判断回滚目标，并安全执行回退；
• 识别常见的版本治理失效场景，如覆盖、错版、漏同步、无验证发布等，并给出预防措施。

二、核心术语的工程化定义

这些术语在本课程中有明确所指，后续章节会反复使用，因此先统一口径。

需要特别强调：版本不等于“另存为”。仅仅把文件改名，不记录变更内容、不标注基线、不区分发布状态，仍然无法治理。版本的价值在于“可识别、可比较、可回退”。

三、治理范围：哪些对象必须纳入管理

Sysmac项目不只是梯形图或ST代码。以下对象都属于版本治理范围：

• 程序组织单元（POU）：梯形图、ST、FBD程序，以及功能块和函数；
• 变量与数据类型：全局变量表、结构体、数组定义，尤其是与HMI、上位机通信的变量；
• 运动控制配置：轴参数、凸轮表（Cam）、齿轮比、软限位、单位换算；
• EtherCAT与I/O配置：从站拓扑、PDO映射、分布式时钟设置；
• 任务与程序分配：主任务周期、优先级、事件任务触发条件；
• 安全相关设置：安全PLC参数、安全I/O映射（如项目涉及）；
• 库文件与自定义功能块：被多个项目复用的 .lib 文件；
• 控制器在线数据：SD卡备份、控制器内置备份、电池保持变量状态。

如果只管理程序代码，而忽略轴参数或EtherCAT配置，回滚时就可能出现“程序回去了、参数没回去”的错位，设备仍然无法正常运行。

四、整体路线图

本课程按“认知—建立—执行—应对—复盘”的逻辑展开，共30章。下图给出治理框架的整体结构，帮助读者建立全局视角。

路线图的核心逻辑是：先统一语言，再建立规范，然后在日常变更中执行，遇到问题能回滚，最后通过复盘持续改进。五个阶段不是一次性完成的，而是循环迭代的。每一次发布都可能产生新的基线，每一次回滚都可能暴露流程中的薄弱点。

五、一个典型场景：为什么需要治理

假设某包装线使用NJ501控制器，初始版本 V1.0.0 已通过验收并冻结为基线。三个月后，工艺要求将封切时间提前50ms。工程师直接在原工程上修改了定时器设定值，保存为 LineA_Main_新.smc2，下载到控制器后设备运行正常，但没有记录改了什么，也没有更新备份。

两周后，另一名工程师发现节拍偏慢，又在此基础上调整了凸轮曲线，保存为 LineA_Main_改.smc2。此时现场控制器里运行的是第二版修改，而SD卡备份还停留在 V1.0.0。如果此时设备出现异常需要回退，团队面临的问题是：回到 V1.0.0 会丢失封切提前的改进；回到第一版修改又没有凸轮优化；而两个“新”“改”文件之间到底差了什么，没有人能说清。

这个场景并不极端，它反映了治理缺失的三个典型症状：命名无意义、变更无记录、基线不更新。本课程后续章节会逐一给出对应的解决手段。

六、本课程的约定

为保持全文一致，本课程采用以下约定：

• 版本号采用 主版本.次版本.修订号 三段式，例如 V1.3.2；主版本用于架构级变更，次版本用于功能增减，修订号用于缺陷修复或参数微调；
• “发布版”指已下载到目标控制器并完成验证的版本；“工作版”指仍在编辑、尚未发布的版本；“测试版”指已下载到测试台但未进入现场的版本；
• 回滚目标优先选择最近的已确认基线，而不是任意历史文件；
• 所有示例中的项目名、参数值、时间均为教学假设，实际使用时需根据设备与工艺要求确定。