企业官网建设流程全解析

在PLC编程这个行当里，调试和改代码是家常便饭。你正盯着一台运行了三年多的设备程序，想临时屏蔽掉某段逻辑看看效果，或者想把一段写废了的代码先“存”起来而不是直接删掉——这时候，注释功能就是你的救命稻草。但问题来了：在STEP 7和TIA Portal里，LAD、FBD、STL、SCL这四种语言的注释方式完全不一样，尤其是SCL这种类Pascal的高级语言，很多从梯形图转过来的工程师第一次用的时候会懵——为什么我选中一段代码按了快捷键没反应？为什么LAD里能直接拖出来的注释框在SCL里找不到？这篇内容就是要把这四种语言里“注释掉所选代码”这件事彻底讲透，从操作步骤到底层逻辑，再到实际项目里怎么用才不出事。不管你是刚接触TIA Portal的新手，还是用了十几年STEP 7的老手，这里面的细节都值得过一遍。

1. 先搞清楚“注释”在PLC编程里到底意味着什么

1.1 注释的两种截然不同的用途

很多人把“注释”当成一个单一概念，但在PLC编程的实际场景里，它至少分两种完全不同的用途，操作方式和后果也完全不同。

第一种是代码注释，也就是在程序里写说明文字，比如“// 这里判断电机过载信号”，目的是给人看，编译器完全忽略。这种注释不影响程序逻辑，写多少都行，是代码可读性的保障。

第二种是注释掉代码，也就是把一段本来会执行的逻辑临时变成不执行的状态。这个操作的本质是让编译器跳过这段代码，但代码本身还留在文件里。调试阶段用得最多——比如你想验证某个联锁条件是不是导致停机的原因，就先把那段联锁注释掉跑一遍看看。

这两种用途在LAD/FBD里操作方式类似，但在STL和SCL里差别就大了。尤其是SCL，因为它是文本语言，注释掉代码的方式和写说明注释的方式在语法上是有区别的，搞混了就会出问题。

1.2 为什么不能直接删除代码

有人可能会说，我直接把不要的代码删掉不就行了，干嘛要注释？这个问题我在实际项目里见过太多次教训。

直接删除的问题在于：第一，你删掉之后如果发现删错了，得重新写一遍，而PLC程序往往涉及复杂的地址映射和变量关联，重写成本很高；第二，在调试阶段你经常需要反复切换“启用/禁用”某段逻辑，删了再写、写了再删，效率极低；第三，很多项目有版本管理要求，你删掉的代码在版本对比时就消失了，没法追溯“当时为什么删的”。

注释掉代码的好处就是可逆。你随时可以取消注释恢复逻辑，代码结构完整保留，版本对比时也能看到“这段代码被注释了”这个动作本身。所以在调试和临时修改场景下，注释掉代码是标准做法。

1.3 四种语言在注释机制上的根本差异

LAD和FBD是图形化语言，它们的“注释掉代码”本质上是通过禁用网络（Network）或者插入注释框来实现的。你没法像文本语言那样在任意位置插入注释符号，操作对象是“网络”这个整体单位。

STL是文本化的指令表语言，它支持行注释，用//开头，可以注释掉单行或多行。STL的注释比较灵活，但要注意它和LAD/FBD混合编程时的显示问题。

SCL是结构化控制语言，语法接近Pascal，支持两种注释方式：//行注释和(* ... *)块注释。注释掉所选代码时，用哪种方式取决于你要注释的范围和代码结构。

这四种语言的注释机制差异，根源在于它们的设计哲学不同：图形语言以“网络”为最小单位，文本语言以“行”或“语句块”为最小单位。理解了这一点，后面的操作就顺理成章了。

2. LAD/FBD里注释掉所选代码的完整操作链路

2.1 禁用网络：最干净的“注释”方式

在LAD和FBD中，最常用的“注释掉代码”方式其实是禁用网络。操作很简单：在程序编辑器中，右键点击你要禁用的网络（Network），在弹出的上下文菜单里选择“禁用网络”（Disable Network）。被禁用的网络会显示为灰色，编译时会被跳过，但代码结构完整保留。

这个操作的底层逻辑是：TIA Portal在编译时会给被禁用的网络打一个标记，生成的机器码里不包含这段逻辑，但源文件里网络还在。你随时可以右键再选“启用网络”恢复。

为什么说这是最干净的方式？因为它不改变代码本身的任何内容，只是给网络加了一个“跳过”属性。对比之下，如果你在LAD网络里插入注释框把代码遮住，那只是视觉上的遮挡，编译时代码照样执行——这是新手最容易犯的错误。

注意：禁用网络和插入注释框是两回事。注释框只是图形上的说明文字，不影响编译结果。要真正让代码不执行，必须用“禁用网络”。

2.2 插入注释框的正确使用场景

那注释框什么时候用？答案是：当你想在程序里写说明文字时用。在LAD/FBD编辑器的工具栏里有一个“插入注释”按钮，点击后可以在网络上方或内部插入一个文本框，里面可以写任意说明。

注释框的典型用途包括：标注某个网络的逻辑意图、记录修改历史、给接手项目的同事留提示。它不会影响程序执行，纯粹是文档性质的。

但这里有个坑：很多人以为把注释框拖到代码上面盖住就是“注释掉”了，实际上代码还在执行。我见过一个项目，调试时有人用注释框把一段停机逻辑盖住了，以为已经屏蔽，结果设备一启动就停机，排查了半天才发现代码根本没被禁用。

2.3 多网络批量禁用的效率技巧

如果一个项目里你需要禁用连续的好几个网络，逐个右键操作太慢。TIA Portal支持多选：按住Ctrl键点击多个网络，或者按住Shift键点击首尾网络选中一个范围，然后右键选择“禁用网络”，可以一次性全部禁用。

这个技巧在调试大型程序时特别有用。比如你要临时屏蔽整个手动模式的所有网络，直接框选那一片区域，一次性禁用，比逐个操作快得多。

还有一个细节：被禁用的网络在编译时虽然不生成代码，但变量声明和符号表里的条目仍然存在。这意味着如果你禁用的网络里用到了某个变量，而这个变量在其他地方没被使用，编译时可能会有“变量未使用”的警告，但不会报错。这个警告可以忽略，不影响程序运行。

2.4 禁用网络后的编译行为和在线表现

禁用网络后，你需要重新编译程序并下载到PLC，禁用才会生效。在在线模式下，被禁用的网络在程序编辑器中显示为灰色，但PLC里运行的确实是不包含这段逻辑的程序。

这里有一个实际经验：如果你在在线模式下修改了程序（比如禁用了某个网络），但没有下载，那么PLC里运行的还是旧程序。TIA Portal会在网络旁边显示一个“未下载”的标记，提醒你当前编辑器和PLC里的程序不一致。调试时一定要确认下载状态，否则你会以为禁用生效了，实际上PLC还在跑旧逻辑。

另外，禁用网络不会影响网络的执行顺序编号。比如你禁用了Network 5，Network 6的编号还是6，不会变成5。这个细节在排查问题时很重要，因为程序执行顺序是按网络编号来的，禁用只是跳过了某个编号的网络。

3. STL中注释掉代码的语法细节和常见陷阱

3.1 行注释的基本语法和适用范围

STL里的注释用双斜杠//开头，从//到该行末尾的所有内容都会被编译器忽略。这个语法和很多编程语言一样，用起来很直观。

比如：

// 下面这行判断电机过载 A "Motor_Overload" = "Alarm_Overload"

第一行就是注释，不会被执行。你也可以在指令后面加注释：

A "Motor_Overload" // 读取过载信号 = "Alarm_Overload" // 输出报警

这种行尾注释在STL里很常见，用来解释每条指令的作用。

但要注意：STL的注释是以行为单位的。你不能用//注释掉一段跨越多行的代码块，必须每行都加//。比如你要注释掉三行指令，得写成：

// A "Start_Button" // AN "Stop_Button" // = "Motor_Run"

3.2 用跳转指令实现“块注释”效果

STL没有原生的块注释语法，但你可以用跳转指令来实现类似效果。具体做法是在要注释的代码段前后加跳转标签：

JU M001 // 跳过下面的代码 A "Start_Button" AN "Stop_Button" = "Motor_Run" M001: NOP 0

这段代码里，JU M001会让程序直接跳到M001标签处，中间的指令不会被执行。效果上等同于注释掉了那三行代码。

但这种做法有个问题：跳转指令本身会占用扫描时间，而且如果跳转标签命名不规范，容易和程序里其他标签冲突。所以这只是一种“应急”手段，长期来看还是逐行加//更清晰。

3.3 STL注释在LAD/FBD视图下的显示问题

这是很多人踩过的坑：你在STL视图里用//注释掉了几行代码，切换到LAD或FBD视图时，这些注释可能会导致显示异常。

原因是LAD/FBD视图需要把STL指令“翻译”成图形网络。如果被注释的代码恰好是某个网络的关键指令，LAD视图可能无法正确渲染这个网络，显示为空白或者报错。

实际经验是：如果你打算在LAD/FBD视图下查看程序，最好不要在STL里注释掉那些构成完整逻辑网络的指令。要么整个网络禁用，要么保持代码完整只在行尾加说明注释。混合注释和代码在同一个网络里，切换视图时出问题的概率很高。

3.4 注释嵌套和特殊字符的处理

STL的//注释不支持嵌套——这听起来是废话，因为行注释本来就不存在嵌套概念。但有一种情况需要注意：如果你的注释内容里包含了//，比如你想写“// 这里参考了//之前的逻辑”，第二个//不会产生任何特殊效果，因为它已经在注释范围内了。

真正需要注意的是特殊字符。STL注释里如果出现中文、特殊符号，在某些旧版本的STEP 7里可能会有编码问题，导致注释显示为乱码。TIA Portal对Unicode的支持好很多，但如果你需要把程序导出到旧系统，建议注释里尽量用英文或拼音。

还有一个细节：STL注释里不能出现*)这样的字符组合，因为某些编译器会把它误认为是注释结束标记。虽然STL本身不用(* *)语法，但编译器内部可能有关键字冲突。保险起见，注释里避免写看起来像语法符号的内容。

4. SCL中注释掉所选代码的两种武器

4.1 行注释//的使用方法和快捷键

SCL的行注释语法和STL一样，用//开头。在TIA Portal的SCL编辑器里，你可以选中一行或多行代码，然后按快捷键Ctrl + /（不同版本可能略有差异，也可以在菜单里找“注释”选项），选中的行会自动在行首加上//。

这个快捷键是切换式的：再按一次，行首的//会被移除，恢复代码执行。这个设计在调试时非常方便，你可以快速在“注释”和“取消注释”之间切换。

比如你写了一段SCL代码：

IF "Start_Button" THEN "Motor_Run" := TRUE; END_IF;

选中这三行，按Ctrl + /，变成：

// IF "Start_Button" THEN // "Motor_Run" := TRUE; // END_IF;

再按一次，恢复原样。

4.2 块注释(* *)的适用场景和嵌套规则

SCL还支持块注释，用(*开头，*)结尾。这种注释可以跨越多行，适合注释掉一大段代码或者在代码中间插入大段说明。

(* 下面这段逻辑暂时不用 IF "Start_Button" THEN "Motor_Run" := TRUE; END_IF; *)

块注释的一个关键特性是支持嵌套。也就是说，你可以在一个(* *)注释里面再写一个(* *)，编译器会正确处理嵌套层级。这个特性在调试时很有用：如果你已经用块注释注释掉了一段代码，而这段代码里面本来就有块注释，不会出问题。

但行注释//和块注释(* *)混用时要注意：//注释掉的行里如果包含*)，不会影响块注释的结束位置，因为//已经让那一行失效了。反过来，块注释里的//也没有特殊含义，只是普通字符。

4.3 选中代码块快速注释的实操步骤

在TIA Portal的SCL编辑器里，最常用的操作流程是这样的：

1. 用鼠标选中你要注释的代码行（可以多选）
2. 按Ctrl + /，选中的行首会加上//
3. 如果要取消注释，再按一次Ctrl + /

这个操作对单行和多行都适用。如果你选中的行里有些已经有//，有些没有，按快捷键后，所有行都会统一加上//（已有的不会重复加）。取消注释时，所有行首的//都会被移除。

对于块注释，没有默认快捷键，需要手动输入(*和*)。但你可以通过自定义快捷键或者代码片段功能来加速这个操作。在TIA Portal的设置里，可以给“插入块注释”分配一个快捷键，具体路径在“设置 > 快捷键”里找。

4.4 SCL注释与编译器的交互：哪些注释会影响编译

这是一个容易被忽略的问题：SCL里的注释虽然不执行，但编译器仍然会解析注释的内容，用来做语法检查。

具体来说，如果你在注释里写了不完整的语法结构，比如：

// IF "Start_Button" THEN

这行注释本身没问题，编译器会忽略它。但如果你写的是：

(* IF "Start_Button" THEN *)

这也是合法的块注释。问题出在注释符号不匹配的情况：

// IF "Start_Button" THEN "Motor_Run" := TRUE; END_IF;

这里只有第一行被注释了，后面两行还是有效代码，但IF被注释掉了，END_IF就成了孤立的语句，编译会报错。所以注释代码时一定要确保注释的范围是完整的语法块，不能只注释一半。

另一个坑是：SCL编译器对注释里的变量名不做检查，但如果你在注释里写了某个变量名，而这个变量在代码其他地方被删除了，编译器不会报错。这听起来是好事，但实际调试时可能导致你误以为某个变量还在使用，实际上只在注释里出现了。

5. 四种语言注释机制的横向对比与选型建议

5.1 操作效率对比：哪种语言注释最快

从操作效率来看，四种语言注释掉所选代码的速度排序大致是这样的：

SCL的行注释快捷键是效率最高的，因为它是切换式的，一键完成注释和取消注释。LAD/FBD的禁用网络虽然步骤少，但只能以网络为单位，没法注释网络内部的部分代码。

5.2 可读性对比：注释后的代码是否清晰

注释后的代码可读性，取决于注释方式是否明确表达了“这段代码被禁用了”这个意图。

LAD/FBD的禁用网络会显示为灰色，视觉上非常明确，任何人打开程序都能一眼看出这个网络被禁用了。STL和SCL的行注释//也很清晰，但如果你注释了大量代码，满屏的//会让代码看起来比较乱。

块注释(* *)在注释大段代码时可读性最好，因为注释边界清晰，不会每行都有注释符号。但缺点是如果注释块很大，你需要滚动才能看到*)结束标记，有时候会忘记这段代码还在注释状态。

5.3 调试场景下的最佳实践

根据实际项目经验，不同调试场景下的最佳注释策略是这样的：

临时屏蔽单个网络：用LAD/FBD的禁用网络，操作最快，恢复也最快。

临时屏蔽网络内的部分逻辑：如果是在LAD/FBD里，建议把要屏蔽的部分单独做成一个网络再禁用；如果是在SCL里，直接用//注释掉对应的行。

长时间保留但不执行的代码：用SCL的块注释(* *)，并在注释开头写明“以下代码暂时禁用，原因：XXX，日期：XXX”。这样接手的人能清楚知道这段代码的状态和原因。

需要频繁切换启用/禁用的代码：用SCL的行注释//配合Ctrl + /快捷键，切换效率最高。

5.4 团队协作中的注释规范建议

如果你在一个团队里工作，注释规范不统一会带来很多麻烦。建议在项目开始时就约定好：

• LAD/FBD程序里，禁用网络必须在网络标题里注明“已禁用”和原因
• STL/SCL程序里，注释掉的代码块必须在开头用块注释写明禁用原因和日期
• 禁止使用跳转指令来实现“注释”效果，因为跳转会影响程序扫描周期
• 所有注释掉的代码在项目交付前必须清理，要么恢复要么删除，不能留在最终版本里

这些规范看起来繁琐，但实际执行后能大幅减少“这段代码为什么被注释了”“能不能删”这类沟通成本。

6. 那些年我在注释代码上踩过的坑

6.1 注释掉安全逻辑导致的事故

这是我职业生涯里印象最深的一次教训。在一个包装线项目里，调试时为了测试某个动作，我把一段安全门联锁逻辑用禁用网络的方式屏蔽了。测试完成后，我恢复了网络，但忘记重新编译下载。结果设备运行了三天，安全门打开时设备没有停机，幸好操作员及时发现没有造成人身伤害。

这件事之后，我给自己定了一条死规矩：任何涉及安全逻辑的注释操作，必须在操作完成后立即恢复并下载，并且在程序里用注释框标注“安全逻辑，禁止禁用”。

6.2 块注释嵌套导致的编译错误

SCL的块注释支持嵌套，这本来是好事，但嵌套用多了容易搞混层级。我有一次在一个已经用(* *)注释掉的代码块里，又用(* *)注释了一小段，结果结束标记的数量对不上，编译器报了一堆莫名其妙的错误。

排查了半天才发现，是嵌套的*)提前结束了外层注释，导致后面的代码被意外注释掉了。从那以后，我尽量不用嵌套块注释，如果确实需要注释一大段代码，就用行注释//逐行处理，虽然麻烦但不会出错。

6.3 注释里的中文导致的编码问题

早期用STEP 7 V5.x的时候，我在STL注释里写了中文，结果程序导出到另一台电脑上打开时，中文全变成了乱码。更严重的是，有些乱码字符恰好被编译器识别成了特殊符号，导致编译失败。

后来我养成了习惯：在STL和SCL的注释里，尽量用英文或拼音。如果必须用中文，确保项目文件保存为Unicode格式，并且在团队内统一TIA Portal的版本和语言设置。

6.4 忘记取消注释导致的“幽灵bug”

这个坑相信很多人都踩过：调试时注释掉了一段代码，测试完成后忘记恢复，程序下载到PLC后，设备运行异常，但排查时看代码逻辑又是对的——因为你看的是注释掉的那段，以为它还在执行。

这种“幽灵bug”最难排查，因为代码逻辑和实际行为不一致。我的应对方法是：在程序里搜索所有注释符号，定期检查有没有遗留的注释代码。TIA Portal支持在项目中搜索//和(*，可以快速定位所有注释位置。

7. 关于注释代码的几个进阶技巧

7.1 用注释实现“条件编译”效果

在SCL里，你可以用注释配合REGION指令来实现类似“条件编译”的效果。具体做法是把不同版本的代码用REGION分隔，然后通过注释掉不需要的REGION来切换代码版本。

REGION Version_A // 版本A的逻辑 "Output" := "Input1" AND "Input2"; END_REGION (* REGION Version_B // 版本B的逻辑 "Output" := "Input1" OR "Input2"; END_REGION *)

这样你只需要注释掉一个REGION，就能切换整个代码块，比逐行注释清晰得多。REGION在TIA Portal里可以折叠，注释掉后代码结构依然清晰。

7.2 注释与版本管理的配合

如果你用Git或SVN管理PLC项目，注释掉代码会影响版本对比。因为注释操作改变了文件内容，版本对比时会显示大量变更。

我的做法是：在提交版本时，注释掉的代码要么恢复，要么删除，不要留在提交里。如果确实需要保留注释状态，在提交信息里写明“注释了XXX逻辑，原因XXX”。这样版本历史才清晰。

7.3 快速定位所有注释代码的方法

TIA Portal的搜索功能可以帮你快速找到项目里所有的注释。在“项目树”里右键选择“搜索”，输入//或(*，可以列出所有包含注释的位置。

这个功能在项目交接时特别有用：你可以快速检查前任工程师有没有留下注释掉的代码，评估这些代码是否需要恢复或删除。

7.4 注释代码对程序性能的影响

最后说一个很多人关心的问题：注释掉的代码会影响PLC扫描周期吗？

答案是：不会。无论是LAD/FBD的禁用网络，还是STL/SCL的注释，编译后的程序里都不包含这些代码，PLC执行时完全跳过。所以注释代码不会增加扫描时间，也不会占用PLC内存（除了源文件占用的存储空间）。

但有一个例外：如果你用跳转指令来实现“注释”效果，跳转本身会消耗少量的扫描时间。虽然影响很小，但在高速扫描的场景下（比如扫描周期小于1ms），这个开销也需要考虑。

我在实际项目里用SCL的Ctrl + /快捷键注释代码的频率，大概比用LAD禁用网络高十倍。原因很简单：SCL的文本编辑方式让注释操作更精细，你可以精确到某一行、某个条件，而LAD只能按网络操作。但LAD的禁用网络在可视化上确实更直观，特别是给不熟悉代码的人看程序时，灰色的网络比满屏的//更容易理解。所以我的建议是：调试阶段用SCL的快捷键快速切换，交付版本用LAD的禁用网络做可视化标注，两种方式配合使用，效率最高。