管理感悟：代码缺的不是注释，而是自解释

　　重复一遍：

　　大家以为有用的注释、文档，其实大多是没用的。汝自己写过什么样的有用注释，文档？

　　以前看到一个说法：代码要有自解释的特性，而不是写大量注释。深以为然。

　　注释咱不说了，自解释什么意思？吾思考，有以下几点：

　　目录名、文件名、函数名、变量名，要够长，能够达到顾名思义的程度。这个说起来容易，其实大多数人做不到。这个时候吾建议照抄。

　　使用标准缩写。如果自己创造了新的缩写和名词，要加以说明，并通用化（即碰到同样情况，使用同样的缩写）。

　　尽量使用final这样的修饰符。

　　其他的还有，模块化、弱耦合、强内聚、代码对齐等等。

　　说起来容易，做起来难。大多数程序员都会当作耳旁风，所以写好代码的人不多（水平差的也看不出来）。

　　自然的，注释、文档都是浪费时间的，不要盲目强调。

管理感悟：代码缺的不是注释，而是自解释相关推荐

eclipse java代码某一行需要修改注释_看看这些Java代码开发规范吧！你好，我好，大家好！...
作为一名开发人员,当你接手他人的项目时,且当你阅读他人的代码时,是有没有遇到脑袋充血,感觉Java要把你"送走"的感觉呢?我们在用Java开发技术进行开发前,一定要牢牢恪守Java ...
59 MM配置-后勤发票校验-维护税代码缺省值
业务背景:维护税代码缺省值事务码:SPRO SPRO路径:物料管理->后勤发票校验->收入发票->维护税代码缺省值第1步,SPRO进入第2步,设置默认的税码配置完成! 202 ...
repo+manifests+git方式管理安卓代码
repo+manifests+git方式管理安卓代码 1.repo的获取 repo只是google用Python脚本写的调用git的一个脚本,主要是用来下载.管理Android项目的软件仓库.(也就是 ...
VBA代码助手,代码库收藏管理工具,代码对齐，破解Excel工程密码，设置隐藏模块
历时一个月的紧张开发,VBA代码助手专业版终于问世了,对原加载宏版VBA代码助手进行了全面升级,焕然一新的代码助手重装上阵,希望一如既往的带给大家最好的代码收藏管理和快速插入体验 ! 以前的老朋友应该 ...
管理感悟：加班与忠诚
管理感悟:加班与忠诚红朝儒生 2018-1-4 关键字:管理加班忠诚简介:本文提出忠诚三条件. 转眼又迎来了2018年.祝大家在2018年能够好运连连. 去年12月20号,吾司一所谓技术高手( ...
git-svn：通过git来管理svn代码
简介 svn和git都是常用的版本管理软件,但是git无论在理念或是功能上都比svn更为先进.但是有的公司是以svn作为中央仓库,这时git与svn代码的同步就可以通过 git-svn这个软件进行,从 ...
python sqlsever 时间_Python sqlalchemy时间戳及密码管理实现代码详解
一.时间戳实际开发中,我们一般希望create_time和update_time这两个属性能自动设置,所以在建表的时候需要在model上特殊处理一下: from sqlalchemy.sql imp ...
管理低代码公民开发人员的8个技巧
作者:Mary Branscombe 编译:帆软数据应用研究院-grace 全文共4300字,阅读需要11分钟. 随着低代码和无代码工具的崛起,将"应用程序缺口"留给企业用户来填补 ...
Git 代码管理（代码提交和代码回退）
Git 代码管理(代码提交和代码回退) Git的主要功能是代码管理,版本管理,分支管理. 在远程代码管理平台上,项目的代码被管理在一个远程代码仓库中,在本地,代码保存在一个本地代码仓库中.通过Git, ...
在PhpStorm中管理GitHub代码仓库的使用方法
2019独角兽企业重金招聘Python工程师标准>>> 1.简介: PhpStorm是一个轻量级且便捷的PHP IDE,其提供的智能代码补全,快速导航以及即时错误检查等功能大大提高了 ...

管理感悟：代码缺的不是注释，而是自解释

管理感悟：代码缺的不是注释，而是自解释相关推荐

最新文章

热门文章