知识卡片

普通读书笔记卡 · 1915.a.7

配置名应表达作用而非场景

理解等级:中级

配置按常见使用场景命名,可能让人把场景误当实际效果。run_locally若只打开额外日志,就会让远程调试或本地性能测试变得难以理解;extra_logging直接说明控制什么。场景可以写在使用说明里,配置名应先表达稳定的行为职责。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      典型环境而得名。用像——extra_logging这样的名字来代换可能会更直接明了。 但是如果——run_locally需要做比额外日志更多的事情怎么办?例如,假设它需要建立和使用一个特殊的本地数据库。现在——run_locally看上去更吸引人了,因为它可以同时控制这

    参考来源

    - 位置:《编写可读代码的艺术》配置作用与使用场景分开命名(spine 2767;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2691.html`;来源键`s2767-ch02-006`)。 - 结论依据:本项正文及图11..52已完整读取;命名效果由具体案例说明,未执行或改写示例。 - 原始内容:典型环境而得名。用像——extra_logging这样的名字来代换可能会更直接明了。 但是如果——run_locally需要做比额外日志更多的事情怎么办?例如,假设它需要建立和使用一个特殊的本地数据库。现在——run_locally看上去更吸引人了,因为它可以同时控制这