ICode9

精准搜索请尝试: 精确搜索
首页 > 其他分享> 文章详细

代码命名规范

2021-09-12 15:33:59  阅读:115  来源: 互联网

标签:缩进 函数 框架 名词 代码 规范 使用 命名


代码规范化基本上有七大原则:

1) 空行    2) 空格    3) 成对书写   4) 缩进  5) 对齐  6) 代码行    7) 注释

另外,还需要一系列的原则,如:

良好的工程结构
目录结构要清晰,例如很多框架采用了mvc设计思想。模型放一个目录,视图放一个目录,控制器放一个目录。大家可以下载相关的mvc设计思想的框架,例如:ThinkPHP、Laravel。

使用DRY原则

不要重复你的代码。拆分可重用函数或类,使用常量定义。

使用有意义并一致命名

不要使用拼音命名,不要没有明确含义的命名。

变量命名:变量的名词性(形容词+名词),长名字可用下划线连接。

函数名:小驼峰式(如:getUserInfo())。函数的动词性(动词+形容词+名词;谓语+宾语)

类的命名:大驼峰式(如:UserInfo)类的名词性:如:OrderModel。不可出现下划线。

适当留空和必要缩进

使用tab键缩进(不可使用4个空格来代替缩进)。

留空(使用空格、换行、空行)

避免深嵌套

嵌套不应该大于3层。函数不应该有多个出口。

添加应有的注释

注释块/**/

文件头:名词,版权,作者。

类:类作用解释。

函数:函数作用,入参数,返回内容。

注释行 //:帮助记忆

代码说明:一般用于对某个逻辑块的说明。

结束提示:常用于if、switch、while逻辑体结束说明。

待开发提示

调试提示

变量声明和初始化

避免声明的局部变量覆盖上一级声明的变量

使用前必须将变量初始化

变量名尽量体现数据类型

永远不要相信用户

天真的用户:只要有输入框,就会出现各种输入内容

不怀好意者:会想办法通过输入注入恶意内容

防范措施:前端对输入进行校验。后端对于输入校验必不可少,不能假设前端做了正确的校验。存在你也不知道的入口。攻击者会直接通过编造请求的方式进行提交。防止各种注入。

合理使用缓存机制

建议使用缓存机制缓存获得更好的性能。例如:redis、memcached等。

避免代码的Copy和Paste

没有理解代码的含义,就呆板的拷贝复制。拷贝来的代码未必就是对的。如果有重复代码,意味着可以拆分出一个功能函数。

尽量多使用框架
框架的目的是为了提高开发效率。框架是前辈们知识和经验积累而来,是被证明了的成熟解决方案。绝大数框架基于MVC(模型视图控制器)架构理念而开发。选择适合自己的框架。

 

标签:缩进,函数,框架,名词,代码,规范,使用,命名
来源: https://www.cnblogs.com/fuxiaoya/p/15258231.html

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有