电气工程师最讨厌的两件事（讨厌的事多了，先挑能明面上能说的）：在写PLC程序时讨厌写注释；在读PLC程序时讨厌没注释。就是这么狗血，就像有人讨厌两种人：一种是黑人，另外一种是种族歧视的人。
写PLC程序讨厌写注释有如下原因：
1、时间成本较高
项目周期紧张：在实际项目中，电气工程师往往面临着紧迫的项目交付时间。编写PLC程序本身就需要耗费大量的精力和时间，尤其是对于一些大型、复杂的项目，程序逻辑复杂，需要处理大量的输入输出信号和控制算法。此时，额外花费时间来详细编写注释会进一步压缩项目进度，导致他们可能无法按时完成任务。
注释编写繁琐：要编写清晰、准确的注释并非易事。电气工程师需要用简洁明了的语言解释PLC程序的功能、逻辑和关键参数，这需要对PLC程序有深入的理解和良好的表达能力。对于一些复杂的控制逻辑，可能需要花费较多的时间来组织语言，确保注释能够准确传达PLC程序的意图。
2、缺乏即时回报
短期没有收益：写注释对于当下的PLC编程工作并没有直接的帮助，不会使PLC程序运行得更快或更稳定。电气工程师在编写PLC程序时，更关注程序的实际功能实现和调试，而注释在短期内不会对这些方面产生明显的影响。他们可能认为与其把时间花在写注释上，不如用于优化程序逻辑或解决实际的编程问题。
个人成就感低：对于电气工程师来说，完成PLC程序的编写和调试，看到设备正常运行所带来的成就感远远大于编写注释。注释只是一种辅助性的文档，不会直接体现电气工程师的技术能力和工作成果，因此他们缺乏写注释的动力。
3、自我认知偏差
认为记忆力超好：一些经验丰富的电气工程师可能会觉得自己编写的PLC程序自己肯定能记住，不需要额外的注释。他们对自己的记忆力和对程序的理解能力过于自信，认为在后续维护或修改程序时能够轻松想起程序的逻辑和功能。然而，随着时间的推移和项目的增多，他们可能会逐渐忘记一些细节，导致在后续工作中遇到困难。
担心代码简洁性：部分电气工程师认为过多的注释会使PLC程序变得冗长，影响代码的整体美观和简洁性。他们更倾向于编写简洁、高效的PLC程序，认为很多变量和功能名称本身应该具有自解释性，而过多的注释会破坏这种简洁性。
没有注释的PLC程序带来的影响：
1、后期维护困难
理解逻辑耗时：当需要对没有注释的PLC程序进行维护或修改时，电气工程师需要花费大量的时间和精力去理解程序的逻辑。他们需要逐行分析代码，推测每个指令和变量的作用，这不仅效率低下，还容易出错。尤其是对于一些复杂的PLC程序，没有注释的情况下，可能需要花费数天甚至数周的时间才能完全理解程序的功能。
难以定位问题：在PLC程序出现故障时，没有注释会使电气工程师难以快速定位问题所在。他们无法通过注释了解PLC程序的设计意图和关键步骤，只能通过反复调试和分析逻辑来查找问题，这会大大延长故障排除的时间，给客户带来严重的影响。
2、团队协作受阻
新人融入困难：在一个团队中，人员流动是不可避免的。当有新的电气工程师加入时，如果PLC程序没有注释，他们将很难快速上手，需要花费大量的时间去学习和理解现有的PLC程序。这不仅会影响新人的工作效率，还会增加沟通成本和培训成本。
沟通效率低下：在团队协作开发项目时，没有注释的PLC程序会给团队成员之间的沟通带来很大的困难。不同的电气工程师可能对程序的理解存在差异，没有注释作为参考，他们在交流和讨论程序时容易产生误解，导致工作效率低下，甚至可能出现错误。
3、知识传承不便
项目交接困难：当一个项目完成或需要转交给其他电气工程师或其他部门时，没有注释的PLC程序会给交接工作带来很大的麻烦。接手的人员可能无法理解程序的设计思路和功能，导致项目无法顺利进行。这不仅会影响项目的进度和质量，还可能带来经济损失，甚至造成人员流失。
经验难以积累：对于非标公司来说，PLC程序是一种重要的技术资产。没有注释的PLC程序不利于公司对技术经验的积累和传承，新员工无法从现有的程序中学习到有用的知识和经验，公司的技术水平也难以得到提升。
自己不写注释就不要期待别人会写注释，现在只能靠强制要求，甚至客户要求程序要有注释已经被电气工程师当成高要求了。怎么说呢，写注释应该既是情分又是本分，对自己要求高的我相信都会自觉地去写好注释。
---
下一主题
