首页 > 其他分享 >新年小目标!代码更规范!代码不规范,运维两行泪

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

时间:2022-10-15 10:34:54浏览次数:48  
标签:运维 代码 规范 注释 程序员 文档 Pycharm TODO

代码不规范,运维两行泪

编程江湖中一直盛传着一个段子,那就是要问程序员最讨厌哪 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

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


# !/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 :
"""

3、习惯Matlab编程的人一开始会很不习惯Pycharm,没法实时查看变量来调试代码,如果想Pycharm查看变量,需要通过Python Console,也可以使用Anaconda的Spyder模块,开发界面和matlab类似,变量实时查看

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

标签:运维,代码,规范,注释,程序员,文档,Pycharm,TODO
From: https://blog.51cto.com/domi/5759096

相关文章