知识卡片
代码表达意图
命名、控制结构与语言表达应让读者看出实际目的,而不是靠炫技或猜测补全。裸参数可改为有意义的表示,复杂写法也应说明它购买了什么收益。当前对自己明显的含义,未必对同事或未来的自己明显;表达清楚仍要与行为、性能需求和边界一起验证。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
- · 代码表达意图
原书出处 · 1 处
- · 查看原书依据
代码必须明确说出你的意图,而且必须富有表达力。这样可以让代码更易于被别人阅读和理解。代码不让人迷惑,也就减少了发生潜在错误的可能。一言以蔽之,代码应意图清晰,表达明确。 但对没有类似背景的人们来说,又会如何——他们能明白吗?也许团队中有一些刚刚转行做开发、没有太多经验的
参考来源
- 位置:《高效程序员的45个习惯敏捷开发修炼之道 (图灵程序设计丛书 11)》25 代码要清晰地表达意图(spine2;来源项目book-sources,`extracted/高效程序员的45个习惯敏捷开发修炼之道 (图灵程序设计丛书 11)/_epub-src/OEBPS/text00000.html`;来源键`u45-ch06-001`)。
- 结论依据:本单元完整正文、文本代码及相关图已实读;历史代码作为论证例,不冒称编译通过、性能测量或生产安全保证,源码排字错误按上下文明确处理。
- 原始内容:代码必须明确说出你的意图,而且必须富有表达力。这样可以让代码更易于被别人阅读和理解。代码不让人迷惑,也就减少了发生潜在错误的可能。一言以蔽之,代码应意图清晰,表达明确。 但对没有类似背景的人们来说,又会如何——他们能明白吗?也许团队中有一些刚刚转行做开发、没有太多经验的