自我总结代码规范,欢迎修正

栏目: CSS · 发布时间: 5年前

内容简介:以下是最近在某代码仓库js中发现不规范的代码,当然还有css规范了,有兴趣的可以自己上网搜索

自我总结代码规范,欢迎修正

  1. 函数块不要太长,太长影响阅读,一个函数做一件事
  2. 避免冗余代码和重复代码
  3. 一个文件做一件事, 整个文件代码不能太长,保持在300~500行以内
  4. 不要提交直接执行的console.log信息,影响它人调试
  5. 不要提交没用的注释代码,影响阅读和开发,如果要查看可以进行版本历史

我的代码规范原则

  • 影响阅读的代码,那就是不好代码
  • 很多很相似的代码,那一定是重复冗余了

以下是最近在某代码仓库js中发现不规范的代码,当然还有css规范了,有兴趣的可以自己上网搜索

代码规范和不规范举例

函数块不要太长,太长影响阅读,一个函数做一件事

太长的函数块

自我总结代码规范,欢迎修正

  • 改良后的函数块
  • 一个函数平均10-20行之间

自我总结代码规范,欢迎修正

避免冗余代码和重复代码

  • 冗余代码示例
  • 如果你发现了很多地方代码很相似,那肯定是代码重复冗余了

自我总结代码规范,欢迎修正

  • 改良后冗余代码示例
  • 发现重复和冗余的规律,统一用函数封装起来

自我总结代码规范,欢迎修正

一个文件做一件事, 整个文件代码不能太长,保持在300~500行以内

  • 文件代码结构划分
  • 一个method可以拆分成文件夹,通过index入口导入
  • 一个文件做一件事,可以看到一个文件才不到200行
  • 还有文件顺序问题,比如vue钩子函数,建议不用把created写在最后

自我总结代码规范,欢迎修正

  • 文件夹结构
  • 公共的css提出来
  • 公共的方法用mixin提出来

自我总结代码规范,欢迎修正

不要提交直接执行的console.log信息,影响它人调试

  • 及时运行的log信息
  • 写代码的时候可以用,提交尽量不要提交console.*信息

自我总结代码规范,欢迎修正

  • 杂乱的log控制台

自我总结代码规范,欢迎修正

不要提交没用的注释代码,影响阅读和开发,如果要查看可以进行版本历史

  • 不要提交注释代码可在版本历史查看

自我总结代码规范,欢迎修正

  • 版本历史

自我总结代码规范,欢迎修正

一起努力吧

自我总结代码规范,欢迎修正

--

作者:刘伟波

链接: http://www.liuweibo.cn/p/252

来源: 刘伟波博客

本文原创版权属于刘伟波 ,转载请注明出处,谢谢合作


以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

C++ API设计

C++ API设计

[美] Martin Reddy / 刘晓娜、臧秀涛、林健 / 人民邮电出版社 / 2013-8 / 89.00

现代软件开发中的一大难题就是如何编写优质的API。API负责为某个组件提供逻辑接口并隐藏该模块的内部细节。多数程序员依靠的是经验和冒险,从而很难达到健壮、高效、稳定、可扩展性强的要求。Martin Reddy博士在自己多年经验基础之上,对于不同API风格与模式,总结出了API设计的种种最佳策略,着重针对大规模长期开发项目,辅以翔实的代码范例,从而有助于设计决策的成功实施,以及软件项目的健壮性及稳定......一起来看看 《C++ API设计》 这本书的介绍吧!

HTML 编码/解码
HTML 编码/解码

HTML 编码/解码

URL 编码/解码
URL 编码/解码

URL 编码/解码

XML 在线格式化
XML 在线格式化

在线 XML 格式化压缩工具