烂代码&7点建议

今天跟大家分享如何写好代码的几点建议,希望在写代码的时候能够提供一些帮助。

1、编码规范

每种编程语言、每个框架都有自己的一套编码规范和编码最佳实践方式,例如 PEP8 是 Python 语言的编码规范,作为 Python 开发者,每个人至少要将 PEP8 读上三五遍,熟记于心并运用在项目中。

2、文档注释

程序员最讨厌的两件事情:一,别人的项目没有文档和注释,二,自己的项目要写文档和注释。

经常看到一些项目连起码的 REAMDME 文件都没有,这跟demo没什么区别。如果你的项目没有文档,一旦有新人进来接手也是一脸懵逼,还显得非常业余。所以,一个正经的项目至少要说明项目的是做什么的,用了哪些东西,程序怎么跑起来等等。

简单的代码自然无需写注释,良好的代码自身就是文档和注释,但是如果有较复杂的代码逻辑就必须用注释来加以说明你当时写这段代码是如何思考的,否则隔两个月自己都不知道写的什么烂代码,还在骂这是哪个傻逼写的。所以,我们写注释应该在该写的时候才写,写多了或者写少了都不合适。还有一种情况就是过期的注释,需求变更代码更新后,发现注释还是旧的。

虽然Python是一门优雅简洁的语言,但是同样离不开注释的帮助,毕竟,代码是写给人看的。

3、避免重复代码

软件设计原则里面有个DRP原则,就是在一个项目里面不要写重复的代码,如果同样的逻辑出现超过两次,那么你就考虑将它进行封装成为一个函数或者公有方法。过多重复的代码到后面将导致很多潜在的问题,一处有问题,导致处处都有改动。

4、测试覆盖率

测试驱动开发(TDD)是目前主流的开发模式,但是我们往往因为项目进度或者懒惰,而将单元测试忽略了。没有单元测试的代码就像一座危楼,你永远都不知道里面有哪些坑,因为一旦改了一处代码,你无法预知对整个系统有什么影响,而单元测试是对代码质量的一种保障,测试覆盖率越高,潜在问题越少。

5、安全意识

安全问题没发生前都是小事,一旦发生将是不可估量的大事情,几年前CSDN这么大一个网站竟然还闹出将密码用明文存储的笑话,可见程序员的安全意思有多低,密码至少要做HASH存储并加盐处理。去年时候大疆的程序员将服务器的key上传到github也是典型的安全意思缺乏。什么东西该同步到代码库什么东西不该放要区分清楚。常见的web安全也要清楚,像SQL注入,CSRF、XSS攻击的基本原理以及如何预防等等。

6、设计与架构

如果设计架构错了,代码写的再好也白搭,好比建房子设计错了,房子在漂亮也华而不实,可能隐藏重大安全隐患。合理的设计与架构在于根据业务做合理的取舍,遵循逐步演进原则,切忌无脑跟风参考 BAT 规模量级来设计你的系统,好的系统都是演变过来的。抛开业务谈技术都是耍流氓。

7、学习交流分享

分享你的所得,和比你厉害的人多交流,多看书学习。

原文发布于微信公众号 - 日常学python(daily_learn)

原文发表时间:2018-07-31

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏张戈的专栏

详解Linux运维工程师必备技能

本人是 Linux 运维工程师,对这方面有点心得,现在我说说要掌握哪方面的工具吧。 说到工具,在行外可以说是技能,在行内我们一般称为工具,就是运维必须要掌握的工...

45310
来自专栏华章科技

如何用Python分析大数据(以Twitter数据挖掘为例)

本教程将会简要介绍何谓大数据,无论你是尝试抓住时机的商人,抑或是寻找下一个项目的编程高手,你都可以学到它是如何为你所用,以及如何使用Twitter API和Py...

2143
来自专栏王清培的专栏

.NET/ASP.NETMVC 深入剖析 Model元数据、HtmlHelper、自定义模板、模板的装饰者模式(一)

阅读目录: 1.开篇介绍 2.Model与View的使用关系(数据上下文DataContext与View呈现) 3.Metadata元数据驱动设计(如何使用中间...

2136
来自专栏Java架构师历程

40天后Java 11将推出的功能有哪些,它们与Java 9和10的不同之处是什么?

Java 10可能是块中的新手,但现在已经是时候谈论Java 11. Oracle向更快的发布周期迈进意味着更多的功能和能力正在以前所未有的速度发展。

2125
来自专栏北京马哥教育

Linux运维工程师的十个基本技能点

本人是Linux运维工程师,对这方面有点心得,现在我说说要掌握哪方面的工具吧! 说到工具,在行外可以说是技能,在行内我们一般称为工具,就是运维必须要掌握的工具。...

40913
来自专栏北京马哥教育

详解Linux运维工程师必备技能

本人是Linux运维工程师,对这方面有点心得,现在我说说要掌握哪方面的工具吧。 说到工具,在行外可以说是技能,在行内我们一般称为工具,就是运维必须要掌握的工具。...

6149
来自专栏软件成本造价评估

软件项目造价评估时的数据类别有哪些?

软件项目造价评估时的数据类别都有哪些分类呢?通常,在进行软件造价时的数据类别可分为3类:业务数据、引用数据、编码数据。 业务数据:也称为用户的核心数据...

1530
来自专栏速成应用小程序开发平台

不用懂技术,免费教大家如何开发制作微信小程序的优惠券功能

微信小程序上线之后,越来越多的企业特别是零售行业,电商行业等流量竞争激烈和流量导向型的,需要线上线下结合。微信小程序,背靠微信10.4亿的月活以及10亿用户,巨...

6432
来自专栏Java架构师进阶

阿里优酷面试经历——学无止境

最近几周与阿里的面试官聊了聊,趁着我还有记忆先写下来。本人近5年工作的JAVA程序员,技术不精。大伙不必太过吐槽。哈哈。我曾两次时间投过简历。

1425
来自专栏喔家ArchiSelf

探索嵌入式应用框架(EAF)

EAF是Embedded Application Framework 的缩写,即嵌入式应用框架。嵌入式应用框架是 Application framework的一...

1613

扫码关注云+社区

领取腾讯云代金券