[千锋上海]初入编程行业的程序员必读编码规范!


为了提高工作效率 , 保证开发的有效性和合理性 , 并最大程度提高程序代码的可读性和重复利用性 , 提高沟通效率 , 需要一份代码编写规范 。
[千锋上海]初入编程行业的程序员必读编码规范!
本文插图
代码规范的重要性
1、促进团队合作 。 项目是由一个团队来完成 , 如果没有统一的代码规范 , 那么每个人的代码必定风格迥异 。 多个人同时开发同一模块 , 等到要整合代码的时候也很头疼 , 可读性差 。
2、减少Bug处理减少低级错误发生 。 再复杂的逻辑看起来也是很清晰 。 规则不统一 , 容易出错 。 步调一致 , 减少细节思考 。
3、降低维护成本方便后面的人进行代码阅读和维护 , 减少程序耦合性 , 方便在之前的模块上扩展一些功能 , 可维护性高 。
4、有助代码审查代码审查有据可依 。 减少代码审查的工作量 , 统一度量标准 。
代码规范的要求
1、良好的工程结构
目录结构要清晰 , 例如很多框架采用了mvc设计思想 。
模型放一个目录 , 视图放一个目录 , 控制器放一个目录 。
【[千锋上海]初入编程行业的程序员必读编码规范!】大家可以下载相关的mvc设计思想的框架 , 例如:ThinkPHP、Laravel 。
2、使用DRY原则
不要重复你的代码 , 拆分可重用函数或类 , 使用常量定义 。
3、使用有意义并一致命名
不要使用拼音命名 , 不要没有明确含义的命名 。
变量命名:变量的名词性(形容词+名词) , 长名字可用下划线连接 。
函数名:小驼峰式(如:getUserInfo()) 。 函数的动词性(动词+形容词+名词;谓语+宾语)
类的命名:大驼峰式(如:UserInfo)类的名词性:如:OrderModel 。 不可出现下划线 。
4、避免深嵌套
嵌套不应该大于3层 。 函数不应该有多个出口 。
5、添加应有的注释
注释块/**/
文件头:名词 , 版权 , 作者 。
类:类作用解释 。
函数:函数作用 , 入参数 , 返回内容 。
注释行 //:帮助记忆
代码说明:一般用于对某个逻辑块的说明 。
结束提示:常用于if、switch、while逻辑体结束说明 。
待开发提示
调试提示
6、变量声明和初始化
避免声明的局部变量覆盖上一级声明的变量
使用前必须将变量初始化
变量名尽量体现数据类型
7、合理使用缓存机制
建议使用缓存机制缓存获得更好的性能 。 例如:redis、memcached等 。
避免代码的Copy和Paste
没有理解代码的含义 , 就呆板的拷贝复制 。 拷贝来的代码未必就是对的 。 如果有重复代码 , 意味着可以拆分出一个功能函数 。
8、尽量多使用框架
框架的目的是为了提高开发效率 。 框架是前辈们知识和经验积累而来 , 是被证明了的成熟解决方案 。 绝大数框架基于MVC(模型视图控制器)架构理念而开发 。 选择适合自己的框架 。