代码之丑——02 乱用英语

编写符合人英语语法规则的代码

1. 违反语法规则的命名

public void completedTranslate(final List chapterIds) { 
List chapters = repository.findByChapterIdIn(chapterIds); 
chapters.forEach(Chapter::completedTranslate); 
repository.saveAll(chapters); }

• completedTranslate 并不是一个正常的英语函数名。从这个名字你能看出，作者想表达的是“完成翻译”，因为是已经翻译完了，所以，他用了完成时的 completed，而翻译是 translate。这个函数名就成了 completedTranslate

常见的命名规则是：类名是一个名词，表示一个对象，而方法名则是一个动词，或者是动宾短语，表示一个动作。

• 以此为标准衡量这个名字，completedTranslate 并不是一个有效的动宾结构。如果把这个名字改成动宾结构，只要把“完成”译为 complete，“翻译”用成它的名词形式 translation 就可以了。所以，这个函数名可以改成 completeTranslation：

2.英语单词的拼写错误

public class QuerySort { 
private final SortBy sortBy; 
private final SortFiled sortFiled; ...}

sortFiled 应该是sortField