查看原文
其他

@程序员,代码清理有必要吗?

CSDN 2018-12-03

【CSDN编者按】日常编程工作中,程序员经常面临各种代码bug。但是是否所有项目都适合清理重构?bug修复的手段又是否合理?本文的作者以原型设计、新项目、紧急bug修复、新功能开发、项目维护等各阶段为例,分别给出了相应的解决方法,希望能对你有所帮助。


以下为译文:

你的项目截止时间就要到了,你有一个紧急的 bug 需要修复,你的项目需要快速迭代输出产品。

虽然你很忙,但是你也必须考虑你的未来:你现在引入的每一个 bug,都会给以后修复带来巨大的时间成本。因此我们不应该使用过时的API、过时的版本依赖、或者一些老旧的做事方法。

所以,我们什么时候来清理我们的代码呢?

  • 现在就做?

  • 以后需求少了再做?

  • 还是永远不做?

本文,我将告诉你该在什么时间去用以下三种方法来清理你的代码:

  • 更新项目依赖和废弃的API;

  • 重构不合适的抽象设计;

  • 编码规范和日常编程习惯等杂项清理。


解决方法


原型设计

在工程构建之前,你会做一些技术调研,做一些原型设计(或者极限编程中的Spike解决方案),但你不会长期保留使用这些代码,你仅仅是使用这些代码来验证是否能解决问题。考虑到你有可能会废弃掉这些代码,更新和规范没有什么需要值得特别注意的事项。如果你也想尝试理解学习那些已经存在的API,你也不需要对代码进行重构。

但是,如果你是想通过原型设计找到更好的抽象方式,你就必须进行大量的重构了。

最佳实践:

  • 更新:不需要处理;

  • 重构:如果你需要找到更好的架构方式,你就需要重构,反之,你就不用在意重构的问题;

  • 杂项清理:不需要处理。

新项目

如果你正在着手搭建一个全新的项目,你的任何一个决定都会给以后带来很大的维护成本。

当然,这也是一个机会,让你可以使用最新的框架,最佳的解决方案,最好的编程规范和最好的架构。虽然你不一定能做到完美,但是你可以使它尽可能的接近完美。

最佳实践:

  • 更新:从现在开始;

  • 重构:从现在开始;

  • 杂项清理:从现在开始。

紧急的bug修复

在这个时候,你需要快速为用户修改 bug。如果你看到了问题需要解决,但是这个问题和当前需要修复的bug无关,我建议你暂时不要动它,等 bug 修复结束了再来处理它。

有些时候,bugfix 有两层含义: 一次是快速解决问题,另一次是你需要让代码更整洁。

最佳实践:

  • 更新:稍后;

  • 重构:稍后;

  • 杂项清理:稍后。

新功能开发中或者不紧急的bug修复

当你有一个正常迭代开发的一个项目,不管你是在做新功能开发,还是bug修复,这个时间是你做代码清理的最佳时机。

在这个时候,你并不需要修复所有你接触到的代码,你需要做的是整理你处理中的代码,并且使你的代码库更加的整洁。详情参考https://ronjeffries.com/xprog/articles/refactoring-not-on-the-backlog/。

最佳实践:

  • 更新:立即更新你用到的代码;

  • 重构:立即重构你用到的代码;

  • 杂项清理: 在你用到的代码中,立即使用新的代码规范等。

项目维护阶段

当你的项目已经开发完成,没有什么新的开发任务的时候,经常几个月才有一些给菜单多加一个选项等这种小的需求修改。

现阶段,你的目标是做少量的修改,让项目稳定运行。重构和杂项清理在现阶段是不必要的,但是你项目需要你及时更新一些框架库的依赖 —— 某些框架库不在提供服务,或者有安全更新。经常更新依赖显然要比5年才更新一次容易得多。

所以不管你是不是因为有bug要修复,你都应该及时的去更新你的依赖项 —— 理想情况下,长期发布更新,以减少对API使用的更新需求。

最佳实践:

  • 更新:现在更新,并且长期发布版本支持;

  • 重构:不需要;

  • 杂项清理: 不需要。


现在与未来的平衡


软件开发是一个持续的过程,不是做完就没事了。现在着手去清理代码,将会为你以后节省时间,尽管你现在赶项目的截止时间,现在着手去做也比放在以后多花几周时间去做要好。

本文只是做一个开篇,与任何其它方法一样,也都有不适用的时候,所以,你需要根据你项目中的实际情况和目标来做一些调整。

原文: https://codewithoutrules.com/2018/11/02/when-clean-up-your-code/

译者:罗昭成

责编:郭芮


推荐阅读:

    您可能也对以下帖子感兴趣

    文章有问题?点此查看未经处理的缓存