PLC Control with ST，V3版本学习笔记03—ST语言的注释！

一个好的PLC程序，没有恰当的注释不能算好程序！

不知道，大家有没有这种体会，有时候改一个动作，翻自己的程序也要搞半天时间，如果是其他来源的程序，没有合适的注释，很难看懂！所以，对于ST结构化文本语言来说，如果没有精简准确的注释，那不管对自己还是交付给他人都是噩梦。

这期和大家分享第三章节的内容：Comments注释。

注释主要就两种：单行注释和多行注释！

单行注释

单行注释始终以//开头，可置于代码行首或行尾（如下图所示）：

注释不仅仅在变量声明区和代码编辑区等都可以，不仅可以放到代码的上方，还可以放到每个代码的后方，用来解释此行代码的意义。

当然也可以用来"注释掉"PLC代码使其不执行（失效状态）。只需在行首添加//即可，这比直接删除代码更有利：既保留未来可能需要的代码，也能通过临时禁用部分代码来排查程序其他位置的错误。

这种方式常常对于修改代码和临时禁用某段代码很有帮助！

多行注释

多行注释，有些也称之为“块注释”。位于“（*”和“*）”之间的内容称为块注释，可用于排除多行代码或编写跨行注释说明。

当然多行代码的注释，在不同软件里面有快捷键可以使用：

只要选中所选的行，不管一行还是多行，例如在CODESYS SP18版本的IDE软件，Ctrl+O，即可注释：

Ctrl+I取消注释。对于不同的编程软件，快捷键的具体实现方式不尽相同，要根据所选择的软件进行操作！

图片

总结

重要原则

• 代码修改后必须同步更新对应注释和版本日志
• 编程前先用注释描述预期功能，可提升代码结构性和可读性

技术说明

• 绿色注释文本为PLC编程环境通用显示标准
• 版本日志建议采用"版本号+修改内容+日期+作者"的标准格式

• 禁用代码时应保留原代码而非直接删除，便于后续恢复