什么是开发规范
约 859 字大约 3 分钟
2025-03-02
无规矩不成方圆,一个优秀的开发团队,必定离不开团队齐心协力规范的制定。
为什么说它是最重要的?因为:开发不规范,同事两行泪!
开发规范是每位软件开发者在团队开发中必须遵守的,比如项目代码统一缩进两格、项目圈复杂度不能超过 10 等等。遵守规范有利于提高项目的开发效率、降低维护成本;而如果你不遵守规范,可能会影响到整个团队的开发进度,别人也不乐意和你合作。
学习建议
开发规范的学习分为 3 个阶段:
- 了解开发规范,有人工遵守规范的意识
- 学会使用工具来帮助自己遵守代码规范,防止人工的疏忽
- 学会为团队项目定制规范
由于每个团队遵循的开发规范不完全相同,所以千万不要死记硬背规范!
建议大家先简单过一遍大厂团队的代码规范手册(相对标准通用一些),以后做项目的时候只要想到了某个规范,就赶紧去查阅文档确认下。当然也可以直接利用开发工具自带的一些代码检查插件,帮你去纠正一些没注意到的问题。
这里建议大家在前期开发项目时,多观察一些编辑器自动给出的 warning 提示,并且尝试把警告消除。
项目做得多了、慢慢养成习惯后,你会发现遵循规范是一件 “水到渠成” 的事情,不用刻意去记。
而当你成为团队的负责人后,在大家动手做项目前,必须先制定一套开发规范,全场动作才能整齐划一!
知识
- 了解开发规范
- 编码规范
- 代码风格
- 变量命名
- 代码格式
- 设计规范
- 开发原则
- 设计原则
- 文档规范
- 文档结构
- 文档格式
- 文档内容
- 编码规范
- 代码校验工具
- 通用: Sonar
- Python: pylint
- 前端: ESLint
- C++: clang-tidy
- Java: CheckStyle
- 制定代码规范
资源
- 书籍
《软件工程:实践者的研究方法》(经典大黑书,讲的非常全面,但同样完整读下来还是有些难度的)
《软件开发的201个原则》(工具书,看一遍挺好的)
阿里巴巴Java开发手册(搜索《Java开发手册》)
- 视频
- 北京大学软件工程
- 大连工业大学软件工程
- 大学课件
- 文档
- Google Java Style Guide(谷歌 Java 代码规范)
尾语
我们要养成开发规范的好习惯这样我们才能输出更加优质的代码~
贡献者
rand777