jjzjj

重构代码,真没有银弹

布加迪 2023-03-29 原文

​译者 | 布加迪

审校 | 千山

我的一位同事在大型项目代码重构方面有丰富的经验,他真诚地与我分享了他如何处理这些繁杂的任务。虽然他做的大部分事情只是坚持不懈地努力,就像在健身房锻炼那样,但这对我来说很有意义。本文分享他的秘诀。

1、组织目录

当你试图为大型项目重构代码时,很快就会碰壁,因为你不知道一开始该做什么,于是你转而开始阅读O'Reilly的技术类图书,或者对软件开发流程或方法(比如TDD和DDD等)产生兴趣。如果是这样,你的策略将以失败告终。

无论如何,你应该实际做起来,而不是寻找所谓的银弹。首先何不组织项目目录?你可以从了解几个风险入手,因为这么做几乎不会导致错误(bug)。

由于大型项目目录通常很凌乱,所以你一开始会发现很难掌握类的范围、类在何处使用。因此,组织目录可以帮助你在修改类之前了解类在项目中有哪种角色和作用域。

有时,你很难理解某些类的作用。在这种情况下,可以创建一些临时目录,比如“legacy”、“garbage”或之类的目录,并将类文件放入其中。如果你逐渐了解了类的含义,可以将它们移到其他适当的目录。

2、多写注释和文档

即使你已经不得不做代码重构,如果仍认为不需要任何注释以获得干净的代码,那么是时候意识到你的代码不再干净了;你要做的就是写大量注释,即使它们看起来冗长多余。

你应该在读代码时可能会产生疑问的代码旁边留下注释。如果你找到了答案,就应该趁还没有忘记,把它们作为注释写下来。

如果代码与你执行的当前任务无关,你可能不想留下注释。不过请仔细想想。如果你不摆脱一种自我强加的约束,你就无法花时间去注释,也看不到未来开始注释的任何迹象。请注意,它们只是注释而已。

接下来,不妨写你不喜欢写的文档。写文档对于代码重构来说也必不可少,尽管这项工作总是让人感到厌烦,有时甚至让人筋疲力尽。

你可能过去或现在参与几个基于“代码即文档”这一规则的项目。如果把一项特性换成新特性,你将需要阅读所有代码才能理解这项特性的功能。另一方面,如果你有无可挑剔的文档,完全可以使用理想的编程来实现这些特性。

“好奇怪。既然代码最终会被重构,我为什么还要写注释和文档呢?”

这种想法是错误的。代码重构是一项持久的工作。你不确定什么时候可以开始,也不确定是否可以凭一己之力开始。有许多注释和文档在将来供你和同事阅读。

3、编写更多的代码

这听起来似乎很简单,但不是开玩笑。

为了评估工作效率,确认提交和修改了几行代码怎么样?比如说,假设你无法在头一个月完成100次提交和10000次添加或删除,那么你可能需要重新审查计划。

不管怎样,不妨尽可能关注编程。你不必事先考虑架构、测试、编程规则或之类的事情,因为你可以边编程边考虑这些事情。如果你首先正视代码编写,就会找到与项目兼容的度量指标。

“你的意思是,我必须一开始就要重写我写的所有代码,是吗?”

是的,你说得对。如果你犯了错误,就重写代码。没有人能够在不遇到失败的情况下完成代码重构。

“话虽如此,还是很难挤出时间写这么多的代码。”

你可能会遇到一些问题,比如办公室会议太多、项目前期时间太长,或者你自身的技能不足。然而,没有什么是一蹴而就的。同样,你没必要寻找银弹,只需不断地努力。

有志者,事竟成。

原文链接:https://medium.com/@cafedeichi/massive-project-code-refactoring-tips-4a973c3bcc7f

有关重构代码,真没有银弹的更多相关文章

  1. ruby - 如何在 buildr 项目中使用 Ruby 代码? - 2

    如何在buildr项目中使用Ruby?我在很多不同的项目中使用过Ruby、JRuby、Java和Clojure。我目前正在使用我的标准Ruby开发一个模拟应用程序,我想尝试使用Clojure后端(我确实喜欢功能代码)以及JRubygui和测试套件。我还可以看到在未来的不同项目中使用Scala作为后端。我想我要为我的项目尝试一下buildr(http://buildr.apache.org/),但我注意到buildr似乎没有设置为在项目中使用JRuby代码本身!这看起来有点傻,因为该工具旨在统一通用的JVM语言并且是在ruby中构建的。除了将输出的jar包含在一个独特的、仅限ruby​​

  2. ruby - 难道Lua没有和Ruby的method_missing相媲美的东西吗? - 2

    我好像记得Lua有类似Ruby的method_missing的东西。还是我记错了? 最佳答案 表的metatable的__index和__newindex可以用于与Ruby的method_missing相同的效果。 关于ruby-难道Lua没有和Ruby的method_missing相媲美的东西吗?,我们在StackOverflow上找到一个类似的问题: https://stackoverflow.com/questions/7732154/

  3. ruby-on-rails - Rails 源代码 : initialize hash in a weird way? - 2

    在rails源中:https://github.com/rails/rails/blob/master/activesupport/lib/active_support/lazy_load_hooks.rb可以看到以下内容@load_hooks=Hash.new{|h,k|h[k]=[]}在IRB中,它只是初始化一个空哈希。和做有什么区别@load_hooks=Hash.new 最佳答案 查看rubydocumentationforHashnew→new_hashclicktotogglesourcenew(obj)→new_has

  4. ruby-on-rails - rails 目前在重启后没有安装 - 2

    我有一个奇怪的问题:我在rvm上安装了ruby​​onrails。一切正常,我可以创建项目。但是在我输入“railsnew”时重新启动后,我有“程序'rails'当前未安装。”。SystemUbuntu12.04ruby-v"1.9.3p194"gemlistactionmailer(3.2.5)actionpack(3.2.5)activemodel(3.2.5)activerecord(3.2.5)activeresource(3.2.5)activesupport(3.2.5)arel(3.0.2)builder(3.0.0)bundler(1.1.4)coffee-rails(

  5. ruby - 在没有 sass 引擎的情况下使用 sass 颜色函数 - 2

    我想在一个没有Sass引擎的类中使用Sass颜色函数。我已经在项目中使用了sassgem,所以我认为搭载会像以下一样简单:classRectangleincludeSass::Script::FunctionsdefcolorSass::Script::Color.new([0x82,0x39,0x06])enddefrender#hamlengineexecutedwithcontextofself#sothatwithintemlateicouldcall#%stop{offset:'0%',stop:{color:lighten(color)}}endend更新:参见上面的#re

  6. ruby-on-rails - 浏览 Ruby 源代码 - 2

    我的主要目标是能够完全理解我正在使用的库/gem。我尝试在Github上从头到尾阅读源代码,但这真的很难。我认为更有趣、更温和的踏脚石就是在使用时阅读每个库/gem方法的源代码。例如,我想知道RubyonRails中的redirect_to方法是如何工作的:如何查找redirect_to方法的源代码?我知道在pry中我可以执行类似show-methodmethod的操作,但我如何才能对Rails框架中的方法执行此操作?您对我如何更好地理解Gem及其API有什么建议吗?仅仅阅读源代码似乎真的很难,尤其是对于框架。谢谢! 最佳答案 Ru

  7. ruby - 模块嵌套代码风格偏好 - 2

    我的假设是moduleAmoduleBendend和moduleA::Bend是一样的。我能够从thisblog找到解决方案,thisSOthread和andthisSOthread.为什么以及什么时候应该更喜欢紧凑语法A::B而不是另一个,因为它显然有一个缺点?我有一种直觉,它可能与性能有关,因为在更多命名空间中查找常量需要更多计算。但是我无法通过对普通类进行基准测试来验证这一点。 最佳答案 这两种写作方法经常被混淆。首先要说的是,据我所知,没有可衡量的性能差异。(在下面的书面示例中不断查找)最明显的区别,可能也是最著名的,是你的

  8. ruby - 寻找通过阅读代码确定编程语言的ruby gem? - 2

    几个月前,我读了一篇关于ruby​​gem的博客文章,它可以通过阅读代码本身来确定编程语言。对于我的生活,我不记得博客或gem的名称。谷歌搜索“ruby编程语言猜测”及其变体也无济于事。有人碰巧知道相关gem的名称吗? 最佳答案 是这个吗:http://github.com/chrislo/sourceclassifier/tree/master 关于ruby-寻找通过阅读代码确定编程语言的rubygem?,我们在StackOverflow上找到一个类似的问题:

  9. 没有类的 Ruby 方法? - 2

    大家好!我想知道Ruby中未使用语法ClassName.method_name调用的方法是如何工作的。我头脑中的一些是puts、print、gets、chomp。可以在不使用点运算符的情况下调用这些方法。为什么是这样?他们来自哪里?我怎样才能看到这些方法的完整列表? 最佳答案 Kernel中的所有方法都可用于Object类的所有对象或从Object派生的任何类。您可以使用Kernel.instance_methods列出它们。 关于没有类的Ruby方法?,我们在StackOverflow

  10. ruby - Net::HTTP 获取源代码和状态 - 2

    我目前正在使用以下方法获取页面的源代码:Net::HTTP.get(URI.parse(page.url))我还想获取HTTP状态,而无需发出第二个请求。有没有办法用另一种方法做到这一点?我一直在查看文档,但似乎找不到我要找的东西。 最佳答案 在我看来,除非您需要一些真正的低级访问或控制,否则最好使用Ruby的内置Open::URI模块:require'open-uri'io=open('http://www.example.org/')#=>#body=io.read[0,50]#=>"["200","OK"]io.base_ur

随机推荐