企业官网建设流程全解析

1. 为什么“注释代码”这件小事值得单独写一篇

在TIA Portal里写程序，注释代码这件事看起来简单到不值一提——不就是选中几行，点一下注释按钮吗？但如果你真正在西门子PLC的工程环境里摸爬滚打过几年，就会发现事情远没有这么简单。LAD、FBD、STL、SCL这四种语言各有各的脾气，注释的方式、能注释的范围、注释后编译器的反应都不一样。我见过太多新手在LAD里框选了一段网络想临时屏蔽，结果发现按钮是灰的；也见过有人在SCL里用//注释了一整段IF语句，编译时报出一堆莫名其妙的错误。

这篇文章要解决的问题很具体：在STEP 7 (TIA Portal)环境下，针对LAD、FBD、STL、SCL四种编程语言，如何正确地注释掉所选代码。我会把每种语言的注释机制拆开讲清楚，包括操作步骤、底层逻辑、常见坑点，以及什么场景下该用注释、什么场景下应该用其他手段（比如条件编译或者禁用块）。适合已经上手TIA Portal但还没把注释这件事彻底搞明白的工程师，也适合从其他PLC平台迁移过来、正在适应西门子这套工具链的朋友。

先给一个全局认知：TIA Portal的注释逻辑和普通文本编辑器完全不同。在LAD/FBD里，你注释的不是“文本”，而是“网络”或“指令盒”；在STL里，注释是行级的；在SCL里，注释才回归到我们熟悉的文本注释方式。理解这个差异，是后面所有操作的基础。

2. 四种语言的注释机制全景拆解

2.1 LAD/FBD：注释的是“网络”，不是“代码行”

LAD（梯形图）和FBD（功能块图）在TIA Portal里共享同一套注释逻辑。你没法像在文本编辑器里那样选中某一行指令然后加//，因为LAD/FBD本质上是图形化编程，每一段逻辑被组织成“网络”（Network）。注释操作的最小单位就是网络。

具体操作：在LAD/FBD编辑器中，点击网络左侧的灰色边框区域选中整个网络，然后右键选择“注释掉”（Comment out），或者使用快捷键Ctrl+Shift+C。被注释的网络会变成灰色显示，编译时会被跳过。

这里有个关键细节：你不能只注释网络中的某一条指令。比如一个网络里有三个串联的触点和一个线圈，你没法只把中间那个触点注释掉。要么整个网络注释，要么用其他方式（比如把触点改成常闭再串联一个永远为真的条件）来临时屏蔽。这是LAD/FBD的硬性限制，很多从三菱或欧姆龙转过来的工程师一开始会很不适应。

注意：注释掉的网络在编译时会被完全忽略，不会产生任何代码。但网络编号不会消失，只是该网络显示为灰色。

2.2 STL：行级注释，灵活但有陷阱

STL（语句表）是西门子的类汇编语言，注释方式更接近文本编辑器。你可以对单行指令加注释，方式是在行首或指令后使用//。比如：

// 这是一行注释 A "Start_Btn" // 启动按钮 JNB _001 L "Counter" + 1 T "Counter" _001: NOP 0

STL的注释有两个位置：整行注释（行首加//）和行尾注释（指令后加//加说明文字）。整行注释的代码在编译时会被跳过，行尾注释只是说明文字，不影响执行。

但STL有个坑：你不能用//注释掉一个完整的逻辑块结构。比如你写了一个A指令后面跟着JNB跳转，如果你把A那行注释掉了，JNB还在，编译就会报错，因为跳转指令依赖前面的逻辑结果。STL的注释是“物理删除”级别的，注释掉一行，那一行就真的不存在了，后面的指令如果依赖它就会出问题。

2.3 SCL：最接近高级语言的注释体验

SCL（结构化控制语言）是西门子的高级语言，语法类似Pascal。注释方式有两种：单行注释用//，多行注释用(* ... *)。这和很多高级语言的习惯一致，上手成本最低。

// 这是单行注释 (* 这是多行注释 可以跨越多行 适合临时屏蔽大段代码 *) IF "Start_Btn" THEN "Motor" := TRUE; // 启动电机 END_IF;

SCL的注释是真正的文本级注释，你可以注释掉任意代码片段，包括半个IF语句、一个表达式的某一部分。编译器在预处理阶段会把注释内容完全剥离，不会产生任何代码。

但SCL也有需要注意的地方：多行注释不能嵌套。也就是说，你不能在一个(* ... *)里面再写一个(* ... *)，编译器会认为第一个*)就是注释结束，后面的内容会被当作代码解析，大概率报错。如果你需要临时屏蔽一大段已经包含多行注释的代码，要么改用//逐行注释，要么先把内部的(* *)改成//。

2.4 四种语言注释能力对比

这张表建议截图保存，实际工程中随时对照。

3. 实操步骤：手把手教你注释掉所选代码

3.1 LAD/FBD中注释网络的完整流程

假设你在LAD编辑器里写了一段电机启动逻辑，现在想临时屏蔽它做测试。步骤如下：

1. 在项目树中打开对应的FC或FB块，进入LAD视图。
2. 找到你要注释的网络，点击网络左侧的垂直灰色条，整个网络会被选中（背景变蓝）。
3. 右键点击，在弹出的上下文菜单中选择“注释掉”（Comment out）。或者直接按Ctrl+Shift+C。
4. 网络变为灰色，网络标题前会出现一个注释标记。
5. 编译整个块（Ctrl+B），确认没有错误。

如果你想恢复注释，选中灰色网络，右键选择“取消注释”（Uncomment），或再次按Ctrl+Shift+C。

实操心得：在LAD里注释网络后，如果后续网络引用了被注释网络中的变量，编译不会报错，但运行时那些变量会保持上一次的值或初始值。这一点在调试时要特别小心，我曾经因为注释了一个赋值网络，导致后面的PID块一直用旧值运算，排查了半天。

3.2 STL中注释代码的正确姿势

STL的注释更灵活，但也更容易出错。推荐的做法是：

• 临时屏蔽单行：在行首加//。
• 临时屏蔽多行：逐行加//，不要试图用某种“块注释”语法，STL没有。
• 行尾说明：在指令后加// 说明文字，这是永久性注释，不影响执行。

一个常见的错误场景：你写了一段带跳转的STL代码，想注释掉前面的条件判断。比如：

// A "Start_Btn" // JNB _001 L "Counter" + 1 T "Counter" _001: NOP 0

这样注释后，L "Counter"会无条件执行，JNB _001被注释了，但_001标签还在，程序逻辑完全变了。如果你只是想临时屏蔽整个逻辑段，应该把从A到T全部注释掉，包括跳转标签。

注意：STL中注释掉的跳转标签如果被其他指令引用，编译会报“未定义的标签”错误。所以注释跳转相关代码时，要么全注释，要么保留标签行只注释指令。

3.3 SCL中注释代码的三种场景

SCL的注释最接近日常编程习惯，但不同场景下选择哪种注释方式有讲究。

场景一：临时屏蔽单行代码

直接在行首加//：

// "Motor" := TRUE;

场景二：临时屏蔽大段代码

用(* ... *)包裹：

(* IF "Start_Btn" THEN "Motor" := TRUE; "Timer".TON(IN := TRUE, PT := T#5S); END_IF; *)

场景三：行尾添加说明

"Motor" := TRUE; // 启动电机，条件由Start_Btn触发

实操心得：在SCL里用(* *)注释大段代码时，如果这段代码里已经有//注释，没问题；但如果里面已经有(* *)注释，就会出问题。我的习惯是：临时屏蔽用//逐行加，永久性说明用//行尾加，只有确定内部没有多行注释时才用(* *)。

3.4 跨语言场景：在SCL中调用LAD块时的注释策略

实际项目中经常出现混合编程：主程序用SCL写，调用的子程序是LAD写的。这时候注释策略要分开处理。如果你想临时屏蔽对某个LAD块的调用，在SCL里注释掉调用行即可：

// "Motor_Control_DB"(Start := "Start_Btn", Stop := "Stop_Btn");

但要注意，LAD块内部的逻辑仍然存在，只是不被执行。如果该块有输出参数被其他代码引用，注释调用后那些输出会保持上次值。更安全的做法是在LAD块内部注释网络，或者在SCL里给调用加一个永远为假的条件：

IF FALSE THEN "Motor_Control_DB"(Start := "Start_Btn", Stop := "Stop_Btn"); END_IF;

这种方式比直接注释更可控，因为块仍然被编译，只是不执行。

4. 常见问题与排查技巧实录

4.1 为什么我的注释按钮是灰色的？

这是LAD/FBD新手最常遇到的问题。原因通常有三个：

• 没有选中网络：必须点击网络左侧的灰色边框，而不是点击网络内部的指令。
• 选中的是多个不连续网络：TIA Portal不支持同时注释多个不连续的网络，只能逐个操作。
• 块被只读保护：如果块来自库文件且被锁定，无法编辑。需要先解除保护或复制到项目中。

4.2 注释后编译报错“未定义的变量”怎么办？

这种情况通常发生在STL中。你注释掉了变量的声明或赋值行，但后面的代码还在引用它。解决方法：要么把相关代码全部注释，要么保留变量声明只注释逻辑行。在SCL中，如果注释掉了变量声明但后面还在用，也会报类似错误。

4.3 SCL多行注释嵌套导致的诡异错误

前面提到过，(* *)不能嵌套。但实际工程中更隐蔽的问题是：你在一个已经用(* *)注释的代码块里，又用//注释了一行，这没问题；但如果你在(* *)里写了字符串包含*)，编译器会提前结束注释。比如：

(* "Message" := 'End of block *)'; *)

这里的*)在字符串里，但编译器不认，它会在字符串中的*)处结束注释，导致后面的';被当作代码解析，报语法错误。避免方法：多行注释里不要出现*)字符序列，或者改用//逐行注释。

4.4 注释掉的代码会影响在线运行吗？

不会。注释掉的代码在编译时就被剥离了，下载到PLC的代码不包含注释内容。但要注意：如果你注释的是网络或行，下载后PLC里就没有这段逻辑了。如果只是行尾说明注释，不影响。

4.5 常见问题速查表

5. 进阶技巧：比注释更好的代码管理方式

5.1 用条件编译替代注释

在SCL中，可以用REGION和END_REGION来组织代码，配合编译指令实现条件编译。虽然TIA Portal对条件编译的支持有限，但你可以用IF加常量条件来模拟：

IF #DEBUG_MODE THEN // 调试代码 END_IF;

把DEBUG_MODE定义为一个常量，需要屏蔽时改常量值即可，不用动代码结构。这种方式比注释更安全，因为代码始终被编译，不会出现“注释后忘记恢复”的问题。

5.2 用禁用块代替注释网络

在TIA Portal中，可以右键点击块，选择“禁用”（Disable）。被禁用的块不会被编译和下载，但代码完整保留。这比逐个注释网络更高效，适合临时屏蔽整个功能块。恢复时只需右键“启用”。

5.3 版本管理中的注释策略

如果你用Git或SVN管理TIA Portal项目，注释代码会导致大量差异。更好的做法是：需要临时屏蔽的代码用条件编译，永久删除的代码直接删掉（版本历史里有记录），不要用注释来“保留”废弃代码。我见过一个项目里注释代码占了30%，后来接手的人根本不敢删，维护成本极高。

实操心得：我的习惯是，调试阶段的临时注释用//，并且加上// TODO: 恢复标记；提交到版本库前，把所有临时注释清理掉。永久性说明注释保留，但只写“为什么这么做”，不写“这行代码是什么”。

5.4 跨平台迁移时的注释兼容性

从其他PLC平台（如三菱GX Works、欧姆龙Sysmac Studio）迁移到TIA Portal时，注释的迁移是个痛点。三菱的//注释在STL中基本兼容，但LAD中的注释网络需要重新组织。建议迁移时先梳理逻辑，把临时注释全部清理，只保留必要的说明注释，减少迁移工作量。

6. 我踩过的坑和最后分享的几个技巧

先说一个我早期犯的典型错误。有一次在LAD里调试一个安全逻辑，我把某个网络注释掉想临时绕过，结果下载后设备直接启动了——因为那个网络是安全条件判断，注释后安全条件被跳过，输出直接导通。幸好是在测试台上，没出大事。从那以后，我在LAD里注释网络前，一定会先确认这个网络的作用，并且在注释后立即在HMI上做一次完整的功能测试。

另一个坑是SCL的多行注释。我曾经用(* *)注释了一大段包含字符串的代码，字符串里有个*)，编译报错报得莫名其妙。后来养成习惯：多行注释前先搜索一下代码里有没有*)，有就改用//。

最后分享几个实用技巧：

• 快捷键：LAD/FBD中Ctrl+Shift+C是注释/取消注释的切换键，比右键菜单快得多。
• 注释颜色：在TIA Portal设置里可以调整注释的显示颜色，我习惯把注释调成深绿色，和代码区分明显。
• 批量注释：SCL中可以用列编辑模式（Alt+鼠标拖动）在多行行首同时加//，效率很高。
• 注释模板：在SCL中定义一个注释模板，比如// [日期] [作者] [原因]，方便追溯谁为什么注释了代码。

这些经验都是实际项目中一点点积累的，希望对你有用。注释代码这件事，说小很小，但用好了能省下大量调试时间，用不好就是给自己挖坑。