如何才能写出高质量代码？

[TheSpectre]

最近在公司写一些业务代码，功能虽然实现了，但是感觉自己写的代码很乱，过几天再去看可能自己都看不懂了更别说别人去看你的代码。各位有什么建议

[TheSpectre]

@noNOno 谢谢

[kinghui]

把下面基本书多撸几遍

- 《程序员修炼之道：从小工到专家》
- 《重构：改善既有代码的设计》
- 《代码大全》
- 《代码整洁之道》
- 《设计模式》

[kinghui]

《代码整洁之道》里有提过，如果代码需要注释那就说明代码表达力不够，而且注释很容易不跟随代码更新从而误导读者（有可能是你自己）。如果你要为某段代码添加注释那么就应该考虑是不是应该换个名字或使用更加富有表达力的代码，如提取到单独的方法并起个好名称。

[cxbig]

多写多练
备注写清楚就不会忘记代码是干什么的
至于结构的规划，是写一个方法做所有的事情还是写一堆可重用的库、应用层只做配置和调用，全凭经验积累。

[Foolt]

@kinghui 表达力再好，几万行的项目里不可能没有注释，尤其是补丁类代码，不写注释后人翻半天才知道你这到底干嘛用，这种情况下阅读代码比翻阅屎山还恶心。

[Foolt]

最重要的是按编程规范写，PHP 比较流行的编程规范是 PSR 规范；
其次是鼓励冗长的命名，避免用缩写，如果非要缩写一定要在注释写出完整名称；
最后是不要忘了写注释，注释又长又臭没关系，不影响工作进度就可以。

[night98]

@kinghui #23 要么变量名全称，否则不用注释真的看起来很难受，尤其类似 redis 缓存命名这种，不看注释你都只能靠猜。

[page470075640]

一颗迭代的心

[qloog]

命名一定要有意义，这样后期看起来就不那么费解了。

[monkeylyf]

追求美

[misaka19000]

重构，多思考，把组件按模块进行划分

[woscaizi]

如果时间允许，多次重构。

[kinghui]

@Foolt
@night98
并不是说不要注释，意思是加注释是最后的办法，要先考虑有没有更好的表达方式，应该把加注释作为最后的选择而不是第一选择，每次把每次加注释都看作是承认代码表达力的失败而作出的妥协。

[429463267]

https://github.com/alibaba/p3c/wiki/Eclipse%E6%8F%92%E4%BB%B6%E4%BD%BF%E7%94%A8%E6%96%87%E6%A1%A3

阿里巴巴发布的代码规范，了解一下