知识卡片

普通读书笔记卡 · 1881.g.2

名字要结合调用上下文理解

理解等级:中级

函数名字不应脱离模块和领域来追求冗长。Fib.fib(n)重复模块信息,Fib.nth(n)则能与上下文共同表达第n项;循环索引i在约定文化里也可能足够清晰。按对象扮演的角色命名,并尊重项目术语,重点是减少歧义,而不是统一禁止短名或把每个名字写成完整句子。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 44 事物命名 · 查看原书依据

      调用通常会带上模块名,因此调用会是 Fib.fib(n)。何不改为 of 或 nth: 在命名时,要不断地寻找方法来阐明你的意思,而这种行为本身将使你在编写代码时更好地理解代码。 然而,并不是所有的名字都必须去参评文学奖

    参考来源

    - 位置:《程序员修炼之道:通向务实的最高境界(第2版)》,`extracted/程序员修炼之道:通向务实的最高境界(第2版)/_epub-src/text/part0016_split_008.html`。 - 结论依据:本处实际展开的论点与例证;正文中的读者边界分析不冒充原书已提供的实现。 - 原始内容:调用通常会带上模块名,因此调用会是 Fib.fib(n)。何不改为 of 或 nth: 在命名时,要不断地寻找方法来阐明你的意思,而这种行为本身将使你在编写代码时更好地理解代码。 然而,并不是所有的名字都必须去参评文学奖