简简单单几条原则:

  1. 模块的用户永远也不应该被模块的行为所迷惑
  2. 模块要尽可能小,但又不能太小
  3. 代码应该被重用,而不是被拷贝
  4. 模块之间的依赖性应该尽可能降到最小
  5. 错误应该尽早被检测出来,最好是在编译时刻

重点讲两个。

模块的用户永远也不应该被模块的行为所迷惑

最简单的方式是写下多且准确的注释,不过我相信大部分很难做到“准确”。我习惯引用涛神的话,将该条规则表述为要求“代码能够自解释”。

看起来简单做起来难。对于Java程序猿,有几种必要的方式可以帮助你尽可能的做到这一点:

  • 除了对外公布的API和部分重要模块,要求自己不加任何注释
  • 使用清晰明确的命名,包括变量、函数、类
  • 被确定命名的类、函数、变量,其功能应单一、确定
  • 使用的时候再声明/创建,并尽可能进行显示的初始化
  • 严格明确对外保证的边界,将精力放在保证公开接口,而不是私有实现
  • 恰当的使用异常和日志,不要用日志代替所有异常,但或许很多ERROR级别的日志都可以用异常来代替
  • 虽然与原则2相悖,但如果合并模块不会使系统变的难以理解,为了简化系统结构我们建议合并部分模块
  • 除非对外发布后不可更改(比如java.util.Set接口),否则,在能保持良好系统结构的前提下,不要面向未来开发(这一点可能很难接受,不过想想什么时候才应该应用设计模式呢?什么时候时候才应该优化性能呢?有需要的时候。如果现在不需要,就不要面向未来开发。)

上述方式并不是充分的,我可能会在以后的开发中继续补充重要的方式,也可能不会。因为你需要掌握的是如何思考,而不是记住这些死知识

上述原则部分参考自Google Java Style Guide,建议二者结合阅读。

错误应该尽早被检测出来,最好是在编译时刻

刷题的时候要时刻牢记:

如果可能,尽早的处理边界条件

对于工程开发,可以改编如下:

如果可能,尽早的发现并处理错误

这里的错误包括异常、逻辑错误等。分为两个方面,发现、处理:

  • 发现:要求我们尽早的发现错误,最好是编译期;如果在运行期,就要在处理正常逻辑之前,尽早的检测出错误。特别的,在开发期间,编写完备的测试用例,尽早发现逻辑错误。
  • 处理:发现错误还不够,我们要处理错误。如果是编译或开发期间发生的错误,修改代码即可;如果是运行期发生的错误,记录日志、提前退出、抛出异常都是值得考虑的选择,选择当前保证和当前场景下最合适的。

该原则要和原则1结合起来(任何原则都要和原则1结合),所以记得让你发现、处理错误的代码也是自解释的。


本文链接:程序猿应该记住的几条基本规则
作者:猴子007
出处:monkeysayhi.github.io
本文基于 知识共享署名-相同方式共享 4.0 国际许可协议发布,欢迎转载,演绎或用于商业目的,但是必须保留本文的署名及链接。

程序猿应该记住的几条基本规则相关推荐

  1. 程序员要记住的几条建议

    1.想清楚,再动手写代码 刚入行的新手,为了展示自己的能力,拿到需求迫不及待地就开始上手写代码,大忌! 在我看来真正写代码的时间只有20%,如果不想清楚,其他的80%时间在改bug. 2.不交流,就会 ...

  2. unity3d游戏开发猜想——当程序猿老去

    程序猿将代码注入生命去打造互联网的浪潮之巅.当有一天他们老了.会走向那里,会做些什么? 非常多年以后,在我60岁的那天早晨,天刚蒙蒙亮我就起床了,先去公园晨练,然后回来做早餐(50岁的时候我学会了做饭 ...

  3. 从此走上一条iOS程序猿不归路。。。

    新的城市,新的生活!前不久刚刚结束了苦逼的面试找工作之旅,期间也小有收货,如今正处年底工作闲暇之余,将前一阵子陆陆续续的总结整理了一下,本人菜鸟程序猿一只,水平有限,本文总结的知识不算深入,比较浅显, ...

  4. 关于程序猿 59 条搞笑但却真实无比的语录

    在大多数人印象中,程序猿都是给人刻板的印象!其实是他们不懂程序猿的世界而已,下面就看看工程师们最爱的59个经典笑话! 1. 一个好的工程师是那种过单行道马路都要左顾右盼的人.(Doug Linder) ...

  5. 防止程序猿和前端狗打架的几条约定

    一个项目或者产品的出生,往往包含需求.开发.测试再到生产,不是前端一个人在战斗,而是一个团队,少则3-4人,多则十几人,那么问题来了,开发人员需要遵守哪些约定,才能不让程序猿和前端狗不打起来呢?    ...

  6. 十二星座程序猿怪咖个性_你中了几条?

    原文链接 摩羯座 摩羯希望被重用,他们不喜欢自己一天没有事情干,他们希望自己忙起来,他们给别人说"没时间.忙着呢"的时候会非常的爽! 他们喜欢把控全局,因此他们肯定是个合格的架构师 ...

  7. 资深程序猿冒死揭开软件潜规则:无法维护的代码

    原始博文公布于: Roedy Green's Mindproducts (http://mindprod.com/unmain.html ).  翻译链接: 点击打开链接 2014年11月25日 03 ...

  8. Android开发之程序猿必需要懂得Android的重要设计理念2(5.20更新版)

    上篇文章介绍了Android开发的设计理念的一部分,并没有得到博友们的多大认可,仅仅看到了一位博友在以下留言期待下一篇文章的发表,为了这小小的唯一支持.我决定继续把后面的8个要点介绍一下,自己也潜心反 ...

  9. 做程序猿的老婆应该注意的一些事情

    转自:http://www.jianshu.com/p/492903fb7005 十一年前我和程序猿第一次见面,还是大一军训期间.我甚至不确定程序猿是否记得那是第一次见面.当时不小心装伪文艺参加了吉他 ...

最新文章

  1. xiaohai.cf index.php,php des 加密 - 北京破小孩
  2. 再见,Kaggle!
  3. 安装LINUX后要怎么找回WIN7启动项?
  4. 吉他入门第一讲~~~~~右手弹奏基础
  5. dataframe 列名重新排序
  6. 「LibreOJ NOIP Round #1」旅游路线
  7. php处理form多文件上传,ajax利用FormData、FileReader实现多文件上传php获取
  8. 加入 Git 版本管理(git的基本使用)
  9. 信息学奥赛一本通(1312:【例3.4】昆虫繁殖)
  10. ga算法matlab,matlab遗传算法ga函数
  11. php.ini 302,302使用nginx和WordPress重定向循环
  12. Microsoft Visual Studio 6.0 安装后,弹出登录Visual SourceSafe Login弹出框!
  13. python3 socket sendall_全网最详细python中socket套接字send与sendall的区别
  14. ubuntu中vim编辑器的安装与基本使用
  15. 安卓效率微商_微商猎手app下载-微商猎手下载 2.6 安卓版 - 河东软件园
  16. 老年人微信教程手绘版|微信入门教程1
  17. JavaScript 基础优化(读书笔记)
  18. Oracle创建HR示例模式
  19. JOJ——基于爬虫的在线测评系统(Online Judge)
  20. upyun java_java-sdk

热门文章

  1. WINDOWS操作系统32位(x86)和64位(x64)的区别
  2. 用VB产生随机任意大小文件挤满硬盘
  3. 定时任务的选型及改造
  4. 要抢足球教练饭碗!切尔西未来或将用上AI教练
  5. CNNIC报告:中国网民超8亿,人工智能取得突出成果
  6. 联想高校AI精英挑战赛中大收官,“人工智能眼科机器人”获全国总决赛最后入场券
  7. Spark createDirectStream 维护 Kafka offset(Scala)
  8. 北上广深的请注意,阿里聚安全来找你玩啦~
  9. Tomcat配置Basic认证方案(一)
  10. 老项目Xcode5.1编译器错误