知识卡片
命名暴露理解
难以给模块、类或函数命名,可能说明职责过多、封装松散,或业务理解不充分。先用一句话说明它负责的业务结果,再检查职责边界,必要时重新分析或重构;不要只用更宽泛的词掩盖问题。名称是发现设计问题的线索,并非名称难找就必然设计错误。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 命名暴露理解
- · 1.3 有意义的命名
原书出处 · 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)。
- 结论依据:原文在“是不是一个方法里实现了太多的功能”附近的定义、实例或代码支撑本卡的核心说明:难以给模块、类或函数命名,可能说明职责过多、封装松散,或业务理解不充分。适用边界按该处前提解释,代码未执行。
- 原始内容:是不是一个方法里实现了太多的功能?或者类的封装内聚性不够?又或者是你对问题的理解还不够透彻,需要获取更多的信息?