1. 课程导入

在自动化工程项目中，PLC程序往往被视为“设备的大脑”。然而，许多工程师对PLC程序的管理方式仍停留在“另存为+日期命名”的阶段：Main_20240315_最终版_v2_改完.smart、程序备份_张工_勿动.zip、现场调试后版本.rar。这些文件名背后，隐藏着自动化行业长期存在的版本管理困境。本课程将以Git为核心工具，系统讲解如何为PLC软件建立可追溯、可协作、可回滚的工程化版本管理体系。

一、PLC软件版本管理的典型痛点

PLC项目具有“软硬耦合、现场变更频繁、多人协作、交付周期长”的特点，导致版本管理问题尤为突出。常见痛点可归纳为以下几类：

• 版本命名混乱：依赖人工命名，缺乏统一规则，无法判断哪个版本对应哪台设备、哪次改造。
• 覆盖丢失：直接覆盖原文件，导致历史逻辑无法找回，现场事故后难以复盘。
• 多人冲突：两位工程师同时修改同一程序，合并时只能人工比对，极易遗漏逻辑。
• 无法追溯：客户问“这个定时器什么时候改成10秒的”，无人能给出准确答案。
• 回滚困难：新版本上线后出现故障，想退回旧版本却找不到完整可用的备份。
• 缺乏评审：程序变更没有记录、没有差异对比，质量完全依赖个人经验。

二、Git工程的核心价值

Git是目前全球最主流的分布式版本控制系统，最初为Linux内核开发而设计。它并不只是“程序员的工具”，其核心能力同样适用于PLC软件工程：

• 完整历史：每一次提交都记录作者、时间、说明和内容差异，形成不可篡改的时间线。
• 分支协作：主分支保持稳定，功能改造在独立分支进行，互不干扰。
• 差异对比：可查看任意两个版本之间的变化，定位逻辑修改点。
• 快速回滚：任何历史版本都可一键恢复，降低现场风险。
• 远程备份：通过Git服务器实现多地备份与团队共享。
• 与CI/CD结合：为后续自动化构建、测试、部署打下基础。

需要特别说明的是，PLC工程文件多为二进制或专有格式（如.smart、.ap16、.zap16、.gxw），Git无法像文本文件那样直接显示梯形图差异。因此，本课程会重点讲解“导出源文件+文本化+规范提交”的组合策略，让Git真正服务于PLC工程。

三、核心原理：从“文件备份”到“版本控制”

传统备份与Git版本控制的本质区别在于：备份是“点的集合”，版本控制是“线的历史”。下图展示了PLC程序从编辑、提交、分支到回滚的完整数据流与状态关系。

上图展示了PLC程序从工作区到远程仓库的完整流转路径，以及分支与回滚在版本时间线上的位置。理解这条数据流，是后续所有Git操作的基础。

四、方法流程：PLC项目引入Git的基本步骤

将Git引入PLC工程，不是简单安装软件，而是建立一套规范。推荐的基本流程如下：

1. 环境准备：安装Git，配置用户名与邮箱，选择Git服务器（GitLab、Gitea或本地裸仓库）。
2. 仓库初始化：在项目目录执行git init，并创建.gitignore排除临时文件、编译缓存和大型备份。
3. 文件规范：约定每次提交必须包含PLC源文件、变量表、注释文档和变更说明。
4. 提交规范：使用统一格式，如[设备编号] 修改内容，便于检索。
5. 分支策略：主分支保持可交付状态，功能改造使用feature/xxx分支，紧急修复使用hotfix/xxx。
6. 远程同步：定期git push到远程仓库，实现团队共享与异地备份。
7. 版本标记：交付节点使用git tag打标签，如v1.0-客户验收。

# PLC项目Git初始化示例
cd D:\PLC_Project\LineA
git init
git config user.name "ZhangGong"
git config user.email "zhanggong@example.com"

# 创建忽略规则
echo "*.tmp" >> .gitignore
echo "*.bak" >> .gitignore
echo "Backup/" >> .gitignore

# 首次提交
git add .
git commit -m "[LineA] 初始版本，包含主程序与变量表"
git branch -M main
git remote add origin http://gitlab.local/plc/linea.git
git push -u origin main

五、案例场景：一次现场改造的版本管理

某包装线需要增加“急停后自动复位”功能。传统做法是工程师直接在现场笔记本上修改并覆盖原程序。引入Git后，流程变为：

• 从main分支创建feature/estop-reset分支；
• 在分支上完成梯形图修改，导出源文件并提交；
• 通过Git差异对比，确认只改动了急停相关逻辑；
• 现场测试通过后，合并回main并打标签v1.3-estop；
• 若测试失败，直接删除分支，主分支不受影响。

六、常见误区与复盘

误区	后果	正确做法
把整个工程目录直接提交，包含大量临时文件	仓库膨胀，提交缓慢，差异混乱	配置.gitignore，只提交源文件与必要文档
提交说明写“修改”“更新”	历史无法检索，复盘困难	写明设备、功能、原因，如“LineA 增加急停复位逻辑”
所有人直接在主分支修改	冲突频繁，稳定版本被破坏	使用功能分支，合并前评审
只在本地提交，不推送到远程	硬盘损坏即全部丢失	每日推送，远程仓库作为唯一可信源
认为Git只能管理文本代码	放弃使用，继续手工备份	结合源文件导出与规范提交，Git同样适用于PLC

七、学习目标与整体课程框架

通过本课程，你将达到以下目标：

• 理解PLC软件版本管理的核心问题与Git的解决思路；
• 掌握Git的安装、配置、提交、分支、合并、回滚等基本操作；
• 能够为PLC项目设计合理的仓库结构、分支策略和提交规范；
• 掌握PLC工程文件的差异对比、评审与交付标记方法；
• 能够搭建团队协作的远程仓库，并处理常见冲突与故障；
• 了解Git与自动化构建、测试、部署结合的进阶方向。

课程整体分为六个部分：基础认知（版本管理痛点与Git价值）、Git核心操作（仓库、提交、分支、合并）、PLC工程适配（文件规范、差异对比、忽略规则）、团队协作（远程仓库、冲突解决、评审流程）、进阶实践（标签、钩子、CI/CD）以及综合案例与复盘。每一部分都围绕真实PLC项目场景展开，确保学完即可落地。