天天看点

新年小目标!代码更规范!代码不规范,运维两行泪

代码不规范,运维两行泪

编程江湖中一直盛传着一个段子,那就是要问程序员最讨厌哪 4 件事?那必须是:写注释、写文档、别人不写注释、别人不写文档。

动手写代码前尽量做到心中有数,思考清楚代码框架结构。现在这世界讲究格局,写代码亦然。 写代码前先回答这么几个问题——这段代码的核心功能是什么?实现它的核心功能需要实现哪些functions? 这些functions需要设计哪些相应的class?这些class如何尽量做到继承,能否从已有的代码库里进行继承来避免重复开发?

能高效一行写完的绝不写两行。 举个简单的python 例子,想要得到0到10的偶数,大部分人会通过遍历+if判断写几行代码,但完全可以通过一行代码达到结果

y = [x for x in range(10) if x % 2==0]      

做好文档规整。 程序员的工作不是学完代码就拉倒的,还包括整理好自己代码的文档介绍,一方面方便工作交接,自己也方便汇报工作,另一方面方便给自己理清思路,为以后使用这份代码做准备。

坐姿端正,保护好你的颈椎。 老程序员都懂,颈椎不好多么影响工作效率。写代码时尽量用大屏,这样不用低头去写,坐姿正确对颈椎、老腰都好,可持续输出才是王道。

新年小目标!代码更规范!代码不规范,运维两行泪

Setup好用的IDE事半功倍。 我写Python用Pycharm

说下Pycharm使用的一些tips:

1、用好TODO

为临时代码使用TODO注释,它是一种短期解决方案。不算完美,但够好了。

TODO注释应该在所有开头处包含”TODO”字符串,后面可以根据个人偏好加上一行注释,解释要做什么之类的。主要目的是为了有一个统一的TODO格式,这样添加注释的人就可以搜索到

# TODO(domi): 优化阈值
# TODO(tony) : 调整变量      

如果你的TODO是”将来做某事”的形式, 那么请确保你包含了一个指定的日期(“2009年11月解决”)或者一个特定的事件(“等到所有的客户都可以处理XML请求就移除这些代码”)。在你提交代码到GitHub的时候,会提示你的todo内容,方便你查看自己的待做事项

2、代码设置模板

在settings->Editor->file and code templates

新年小目标!代码更规范!代码不规范,运维两行泪
# !/usr/bin/env python
# -*- encoding: utf-8 -*-
"""
@File   : ${NAME}.py    
@Contact: xxxxx
@Usage  : 
@Modify Time        @Author        @Version        @Desciption
------------        -------        --------        -----------
${DATE} ${TIME}     domi           1.0             None
@TODO   :
"""