因为今天读到了合作者(叫他 J 好了)的意味不明的代码,我开始阅读 The Art of Readable Code… 但为什么是我在读…我要直接修改他的代码吗…#TheArtOfReadableCode
总之读到有单位的 variable 附上单位比较好,比如返回的是毫秒就写 elapsed_ms…感激!我代码里有一个地方把 degrees 转成 radians,我只在转换的地方写了个注释,我考虑直接改变量名…
俺就很想吐槽 graphics api 里各种长到不行也还是看不懂在干嘛的函数名…
但问题是做运算的时候会希望名字短很多,比如一条射线的起点和方向,o 和 d,会有一些 o * o + d * d 这样的东西,写成 origin * origin + direction * direction 就很难看,sqr(o) + sqr(d) 倒是勉强增加可读性…总之比较难看懂但是看懂了之后又比较方便…如果这是 class member 的话我一般会在 class definition 里面给个注释…
噢还有跟合作者对于格式的习惯不一的时候应该怎么办捏
今天一直在贯彻书里的知识
@unagi 商量出一个双方都接受的style guide,写下来。
本吧服务器位于德国。欢迎小伙伴们分享生活和语言豆知识。 新用户注册请 1. 填写详细的申请理由,或者附上别处的社交账号。 2. 给出 Rhabarberbarbarabar 的中文翻译。
但问题是做运算的时候会希望名字短很多,比如一条射线的起点和方向,o 和 d,会有一些 o * o + d * d 这样的东西,写成 origin * origin + direction * direction 就很难看,sqr(o) + sqr(d) 倒是勉强增加可读性…
总之比较难看懂但是看懂了之后又比较方便…如果这是 class member 的话我一般会在 class definition 里面给个注释…