本文转载自嵌入式资讯精选公众号,特此鸣谢

有很多理由都能说明为什么我们应该写出清晰、可读性好的程序。最重要的一点,程序你只写一次,但以后会无数次的阅读。当你第二天回头来看你的代码时,你就要开始阅读它了。当你把代码拿给其他人看时,他必须阅读你的代码。因此,在编写时多花一点时间,你会在阅读它时节省大量的时间。

让我们看一些基本的编程技巧:

1. 尽量保持方法简短

尽管很多人都遵循这个规则,但它仍然非常的重要。你写的方法要始终能在一个屏幕里放得下。如果需要去滚动屏幕,这会分散你的注意力,而且你看不到整个的上下文。最佳长度是5-20行,这根据你的情况而定。当然,getters/setters 通常是一行代码的方法,但与其说它们是真正的方法,不如说它们只是存取工具。

2. 永远不要把同一个变量用于多个不同的目的

一个变量应该始终只为一个目的服务。通过使变量常量化(C++里的const, Java里的final),使得编译器能够优化编译,而且使你的代码醒目表达这个变量是不能改变的,你的程序的可读性会变得更好。

3. 使用自描述的变量名和方法名

对于任何人来说,你的代码应该只要看一眼就能知道是干嘛的。尽量不要用简写方式,除非有特殊的习惯,就像下面的:

src - source

pos - position

prev - previous

如果你认为描述性的名称并不是那么有价值,请对比一下n, ns, nsisd 和 numTeamMembers, seatCount, numSeatsInStadium。

4. 尽可能把变量定义在靠近使用它的地方

盖房子时,你可不希望把锤子放到别人的院子里。你希望把它们放的离手头越近越好。定义变量也是同样的道理。

int foo = 3;

int bar = 5;

// 一大段使用“bar”的代码,

// 但没用到“foo”

// ...

baz(foo);

这段代码可以简单的重构成

int bar = 5;

// 一大段使用“bar”的代码,

// 但没用到“foo”

// ...

int foo = 3;

baz(foo);

当你把变量的声明和第一次用到它的地方间隔太远时(距离超过一个屏幕),这确实会成为一个问题。记住上下文关系会变得困难,你需要滚动屏幕去找哪来的这个变量。

5. 拒绝神秘数字

当你要把什么东西跟一个常量值做比较时,记得把这个值定义成常量。没有什么会比去猜测你的同事写的这样的代码更让人头疼的事了:

il < 4384

换个形式感觉如何?

inputLength < MAX_INPUT_LENGTH

6. 友好地对待你的语言

学习新语言是一种很有乐趣的事情,你能学到一种新的完成任务的途径。当一个对一种语言已经很专业的人去学习另一种语言时,会出现一种很大的负面效应。比如说你是一个Java开发者,试图去学习Ruby。你应该学会用Ruby的方式解决问题,而不是沿用Java的解决问题的思想。

当你需要重复5遍”Hello world!“时,在Java里,你可能会这样做:

for (int i = 0; i < 5; i++) {

System.out.println("Hello world!");

}

在Ruby里,你也许会禁不住这样写:

for i in (0..5)

puts "Hello world!"

end

这样看起来没问题,但有一个更好的方式:

5.times { puts "Hello world!" }

7. 不要逆常规而行

每种语言都有自己不同的习俗约定。一般来说,人们听的最多的是Java的编码规范。让我们看看其中的一些习俗规范:

方法名应该小写字母开头,其后用字母大写的单词连接(veryLongVariableName);

类名应该都使用首字母大写的单词连接而成;

常量名应该全部大写,用下划线连接(MY_CONSTANT);

左大括号应该跟 if 语句在同一行。

只有在有必要的理由时才去打破这些常规,不要轻易的因为你不高兴就违反它。如果你只是在团队里改变一些这样的习惯,那也没问题,但当把你代码拿出来和其他的没有这些思想准备的程序员共享时,问题就会来了。

8. 警惕过早优化

过早优化是所有问题的根源,至少电视上是这么说的 … 你第一应该关心的事情是写出易于理解的代码。起初写的程序不要求快。

除非你的程序很慢,否则谈优化都是为时太早。如果你想优化什么东西,你首先需要知道问题出在哪。这就是我们需要profilers这个工具的原因。

在没有知道问题在哪的情况下试图对程序进行优化,其结果必然是把程序能坏,至少你的代码会丧失可读性。如果你觉得有些地方很慢,不要盲目的重写代码,你应先找到慢的证据。

不要傻乎乎的去解决根本不存在的问题。

9. 积极重构测试过的程序

没有任何东西会是完美的。即使你感觉你真正写出了一段完美的代码,几个月后回头再看看,你可能会惊讶道”怎么会这样傻?“

改进程序的一个好方法就是重构,但要等程序测试通过之后。你首先要确保程序是好的可运行的,你可以通过自动化测试或手工测试完成这个工作。

之初,你需要的是程序可用。不要期望在第一次就写出完美的程序,你只需要把它写出来,可用。然后重构它,使之完美。对于你们当中知道测试驱动开发 (TDD)的人来说,对这个会很熟悉。这里的关键就在于你要习惯于重构这种事情。如果你使用的是像IntelliJ IDEA这样强大的集成开发工具的话,重构的工作会变得简单的多。

重构之后,你也许会弄出一些Bug,导致某些功能出问题。这就是为什么说写自动化测试的原因。不论何时重构后,只要运行一下所有的测试用例,你就能准确的知道什么地方出了问题。

10. 不要过度沉迷于技巧

当我第一次读到有关设计模式的知识时,我觉得我找到了圣杯。这些精心设计的思想作用显著,它能使你的设计易于理解,因为你可以简单的说”我使用的是 ‘观察器模式’“,而不用从头到尾的解释一遍。那么,有问题吗?一切看起来都这么自然、简单,你开始不论在哪都使用设计模式。为什么不把这个类做成 singleton呢?干嘛不去再创建一些工厂类呢?

于是一个80行就能写完的脚本,你最终使用了10个类,15个接口,外加一大堆范式和标记符。97%的代码不做任何事情。设计模式是一种十分有用的用来简化你的设计的工具,但这不意味着你该在所有能用到的地方都用它。你应该用它们,但不能滥用。

11. 通过习例学习新知

编程是一种学习新知的过程。当你学到了新的程序库或新语言,你可能会迫不及待的丢掉旧的代码,用你新学到的东西重新写一遍。有很多的理由都能说明你不该这么做。

往现有的应用里增加新的类库或框架同属于这种情况。就说你写了一个Javascript的web应用,期间,你发现了jQuery。现在你突然急切的想丢到你的Javascript程序,重新用jQuery写,尽管你还从来没用过它。

最好的方式是你先用jQuery写一些简单的例子,通过这种方式把你在应用里将要用到的知识都学会。需要AJAX?在你的项目之外做一些小例子,当完全弄懂了后,丢掉例子,应用到你的产品里。

如果你非常关注编程技术,推荐你阅读Steve McConnell写的 《代码大全》 一书,它会改变你对编程的认识。

【转】使用这11个编程技巧,你的程序谁都能读懂!相关推荐

  1. 网络编程懒人入门(十一):一文读懂什么是IPv6

    本文同时发布于"即时通讯技术圈"公众号,链接是:https://mp.weixin.qq.com/s/cS5xB2DrjF52rmz6EGVJ6A. 本文参考了公众号鲜枣课堂的&q ...

  2. 网络编程之一泡尿的时间,快速读懂QUIC协议

    网络编程之一泡尿的时间,快速读懂QUIC协议 TCP协议到底怎么了? QUIC协议登场 QUIC协议的目标 QUIC协议这么好,可以大规模切换为QUIC吗? QUIC协议实践 我想试试QUIC协议,可 ...

  3. 网络编程懒人入门(十二):快速读懂Http/3协议,一篇就够!

    本文中文译文由作者"ably.io"发布于公众号"高可用架构",译文原题:<深入解读HTTP3的原理及应用>.英文原题:<HTTP/3 dee ...

  4. chatGPT技巧攻略.方法大全一文读懂

    这篇文章将带领你系统地掌握ChatGPT以及相关人工智能的使用方法.本文没有废话,全部都是实际操作内容,即使是完全不了解的新手也能轻松理解并开始使用.超级丰富实用的内容!全文包含1万字,作者倾尽心血! ...

  5. 怎么提高计算机编程能力,提高程序员技能的11招编程技巧

    1.清晰的分析问题 2.三思而后行如何解决这个问题 3.收集完整的需求. 花点时间,想好产品的目标形态和最终的用户群.在这个阶段思路清晰会给以后节省很多时间. 4.写一个执行计划 对于比较大的项目,将 ...

  6. 每个程序员都应该读的非编程书

    1.<银河系漫游指南>by Douglas Adams 推荐数:480 生活,宇宙,所有的一切. "看在前,思考在后,然后去实践.但是看总是在最前面.否则,你只能看到你以为的样子 ...

  7. 国外程序员推荐:每个程序员都应该读的非编程书

    五年前有网友在 Stackoverflow 发帖提问:『程序员应该读哪些非编程方面的书?』.有很多程序员响应,他们在推荐的同时也写下了自己的评语.本文摘编其中 29 本书,下面就按照各书的推荐数排列. ...

  8. 【程序员杂谈】国外程序员推荐:每个程序员都应该读的非编程书

    本文由  伯乐在线  -  abell123  翻译自  Stackoverflow .欢迎加入 技术翻译小组 .转载请参见文章末尾处的要求. [伯乐在线导读]:五年前有网友在 Stackoverfl ...

  9. 一篇就够 编程常用英语单词 程序员都要知道单词

    "我英语不好可以学编程吗"这个问题,困扰着太多想学习编程,但英文不好的同学. 愿你心如花木,向阳而生 学习编程,常用的单词就那么多,认识下面这些,一法通万法通. A abstrac ...

最新文章

  1. 【Java面试题】54 去掉一个Vector集合中重复的元素
  2. 怎样从tensorflow的generator object Estimator.predict at 0x7fb1ecefeaf0中取数据
  3. Beyond Compare 4比较文件夹要设置基键吗?
  4. 循序渐进看Java web日志跟踪(1)-Tomcat 日志追踪与配置
  5. python把列表样式的字符串重新转换为列表
  6. 算法竞赛入门经典(第二版) | 例题4-5 追踪电子表格中的单元格 (UVa512,Spreadsheet Tracking,World Finals)(解法二)
  7. Java多线程——不变性与安全发布
  8. strtus2改成springboot_ssh框架使用springBoot升级迁移替换Struts2
  9. C51数据类型扩充定义
  10. 关于组装电脑装win10不得不说的小故事
  11. 为何手机厂商如此热衷 5G?
  12. ProtoBuf与JSON
  13. BAD SYSTEM CONFIG INFO 修复办法
  14. 【OpenCV】—图像对比度、亮度值调整
  15. 一组数据,带你读懂“2021中国民营企业500强”背后深意
  16. XY6762/XY6765/XY8788 如何使用 DCT 工具配置 DWS 文件?
  17. GitHub、Google等镜像加速地址
  18. 寻找最给力的恢复软件(数据恢复软件大PK)数据恢复软件测评报告:
  19. oracle表空间文件压缩,收缩Oracle表空间物理文件
  20. MySQL数据库8(一)SQL简介

热门文章

  1. Kali开机启动配置选项
  2. 四个提高用户活跃度的经验分享
  3. 智云android开发平台,智云平台app
  4. 数据库操作重点总结记录 ExecuteReader OleDbDataReader...
  5. python pdb_python调试:pdb基本用法(转)
  6. layui 表格每列相同行进行合并
  7. 1.3-CPU性能-CPU 使用率
  8. 医院全成本分析---数据来源网络,有部分自己的理解
  9. sql中exists用法
  10. 阿里云如何配置mysql数据库服务器配置_mysql数据库安装配置