知识卡片

普通读书笔记卡 · 6991.r.5.a.15 · 生成模型:未记录

定位标记不能替代清楚结构

理解等级:中级

长分隔线、Actions栏和右括号后的while标记,可能帮助偶尔定位,也可能淹没真正内容。若反复需要标记才能知道自己处在哪个嵌套,宜先检查函数层次和职责。少量有明确导航价值的标记可保留,不必为了反对装饰把生成代码或特殊布局一律重写;目标是降低定位负担。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《代码整洁之道》全书 · 第4章 注释,spine013单元008;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0011.xhtml。 - 结论依据:原文承认少量栏可能有用,并将括号标签联系到深嵌套,支持先解决结构问题而非机械删除所有导航。未在本机运行示例或改变环境。 - 原始内容:尽量少用标记栏,只在特别有价值的时候用。如果滥用标记栏,就会沉没在背景噪音中,被忽略掉。 4.4.10 括号后面的注释 有时,程序员会在括号后面放置特殊的注释,如代码清单4-6所示。尽管这对于含有深度嵌套结构的长函数可能有意义,但只会给我们更愿意