知识卡片
配置名应表达作用而非场景
配置按常见使用场景命名,可能让人把场景误当实际效果。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看上去更吸引人了,因为它可以同时控制这