知识卡片

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

不同名称应说明不同角色

理解等级:中级

copyChars的source/destination说明谁提供数据、谁被写入,比a1/a2更能揭示调用责任。类似CustomerInfo与Customer若没有清楚约定,只是制造多个看似可选的名字。Info、Data等词并非天然无意义;只有当它们确实标识不同层次或内容时才值得保留,不能为通过重名限制随意加字。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 3 处

    参考来源

    - 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元002;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。 - 结论依据:原文参数方向和Info/Data混淆对照,支持语义角色区分而非数字或废词;原文也允许有意义前缀,故不绝对禁词。未在本机运行示例或改变环境。 - 原始内容:是废话远远不够,即便这足以让编译器满意。如果名称必须相异,那其意思也应该不同才对。 以数字系列命名(a1、a2,……aN)是依义命名的对立面。这样的名称纯属误导——完全没有提供正确信息;没有提供导向作者意图的线索。试看: public static