知识卡片

普通读书笔记卡 · 6068

命名暴露理解

理解等级:未标注

难以给模块、类或函数命名,可能说明职责过多、封装松散,或业务理解不充分。先用一句话说明它负责的业务结果,再检查职责边界,必要时重新分析或重构;不要只用更宽泛的词掩盖问题。名称是发现设计问题的线索,并非名称难找就必然设计错误。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 2 处

    • · 查看原书依据

      命名的过程本身就是一个抽象和思考的过程,在工作中,当我们不能给一个模块、一个对象、一个函数,甚至一个变量找到合适的名称的时候,往往说明我们对问题的理解还不够透彻,需要重新去挖掘问题的本质,对问题域进行重新分析和抽象,有时还要调整设计和重构代码。因此,好的命名是我们写出好

    • · 查看原书依据

      是不是一个方法里实现了太多的功能?或者类的封装内聚性不够?又或者是你对问题的理解还不够透彻,需要获取更多的信息?

    参考来源

    《代码精进之路:从码农到工匠(异步图书)》第1章《命名》 - 位置:《代码精进之路:从码农到工匠(异步图书)》1.2 命名其实很难(spine1;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00000.html;u008-ch01-001)。 - 结论依据:原文在“命名的过程本身就是一个抽象和思考的过程”附近的定义、实例或代码支撑本卡的核心说明:难以给模块、类或函数命名,可能说明职责过多、封装松散,或业务理解不充分。适用边界按该处前提解释,代码未执行。 - 原始内容:命名的过程本身就是一个抽象和思考的过程,在工作中,当我们不能给一个模块、一个对象、一个函数,甚至一个变量找到合适的名称的时候,往往说明我们对问题的理解还不够透彻,需要重新去挖掘问题的本质,对问题域进行重新分析和抽象,有时还要调整设计和重构代码。因此,好的命名是我们写出好 - 位置:《代码精进之路:从码农到工匠(异步图书)》1.3 有意义的命名(spine1;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00000.html;u009-ch01-001)。 - 结论依据:原文在“是不是一个方法里实现了太多的功能”附近的定义、实例或代码支撑本卡的核心说明:难以给模块、类或函数命名,可能说明职责过多、封装松散,或业务理解不充分。适用边界按该处前提解释,代码未执行。 - 原始内容:是不是一个方法里实现了太多的功能?或者类的封装内聚性不够?又或者是你对问题的理解还不够透彻,需要获取更多的信息?