随笔 - 142  文章 - 2  评论 - 4  阅读 - 57303

高素质——注释是关键!

       作为一名平凡的菜鸟程序员,写代码的时候,我们往往不倾向于写注释。思考自己,自己何尝不是呢?


       首先来看看不写注释的原因:

    公司或者开发团队的代码规范不是很全面,关于注释,命名没有统一准确的说明;


    本模块的类似功能已经写过很多遍了,比如那些查询,一大部分代码都是极其类似的,所以我们往往就喜欢犯懒;


    模块功能比较复杂,自己的思路主要放在了代码实现的功能上了,而忽视了代码的规范;


       然后来看看不写注释的危害:


    没有统一规范,无论是关于命名、注释,以及程序员的编程习惯,都会使代码各式各样,不便于阅读;


    上升到思想上,不写代码注释绝对是自私自我的表现,自己写的代码是给别人看的,如果你写的代码平白无故的给别人增加了一倍甚至两倍的工作量,那么这样的代码不能说是好代码;


    我们一天能写出几千行代码,我们写出的代码往往是站在我们实现的角度的,没有站在用户体验的角度去写代码,命名不规范,注释不完整……这样的代码没法看所以我们还一直是菜鸟程序员。


       最后来仔细分析一下:


    对于类似的功能不去写注释,这就要说明我们的思想觉悟还是不够,不知不觉得总是站在自己的实现角度来思考问题,也难怪有人言“人之初、性本恶”。这不仅仅是个人问题,这是观念问题,这种小农关键不改,我们一定写不出优秀的代码;


    模块功能复杂,而忽视了代码规范说明我们还没有将编程规范融成自己的习惯,说明我们做的还不够。


       总结


    我们应学会做一个会勉强自己的人,很多时候我们要做的事情,并不是我们想做的事情。战胜自己,我们才是真的自己。


posted on   刘正权的博客  阅读(169)  评论(0编辑  收藏  举报
编辑推荐:
· .NET Core 中如何实现缓存的预热?
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列:如何用heaptrack跟踪.NET程序的非托管内存泄露
阅读排行:
· TypeScript + Deepseek 打造卜卦网站:技术与玄学的结合
· 阿里巴巴 QwQ-32B真的超越了 DeepSeek R-1吗?
· 【译】Visual Studio 中新的强大生产力特性
· 10年+ .NET Coder 心语 ── 封装的思维:从隐藏、稳定开始理解其本质意义
· 【设计模式】告别冗长if-else语句:使用策略模式优化代码结构
< 2012年11月 >
28 29 30 31 1 2 3
4 5 6 7 8 9 10
11 12 13 14 15 16 17
18 19 20 21 22 23 24
25 26 27 28 29 30 1
2 3 4 5 6 7 8

点击右上角即可分享
微信分享提示