规范

Python编程规范及性能优化

北战南征 提交于 2020-12-19 06:00:57
Python编程规范及性能优化 Ptyhon编程规范 编码 所有的 Python 脚本文件都应在文件头标上 # -*- coding:utf-8 -*- 。设置编辑器,默认保存为 utf-8 格式。 注释 业界普遍认同 Python 的注释分为两种的概念,一种是由 # 开头的“真正的”注释,另一种是 docstrings。前者表明为何选择当前实现以及这种实现的原理和难点,后者表明如何使用这个包、模块、类、函数(方法),甚至包括使用示例和单元测试。 坚持适当注释原则。对不存在技术难点的代码坚持不注释,对存在技术难点的代码必须注释。但与注释不同,推荐对每一个包、模块、类、函数(方法)写 docstrings,除非代码一目了然,非常简单。 缩进 Python 依赖缩进来确定代码块的层次,行首空白符主要有两种:tab 和空格,但严禁两者混用。如果使用 tab 缩进,设定 tab 为 4 个空格。 公司内部推荐使用 4 个空格的 tab 进行缩进。 空格 空格在 Python 代码中是有意义的,因为 Python 的语法依赖于缩进,在行首的空格称为前导空格。在这一节不讨论前导空格相关的内容,只讨论非前导空格。非前导空格在 Python 代码中没有意义,但适当地加入非前导空格可以增进代码的可读性。 1)在二元算术、逻辑运算符前后加空格:如 a = b + c; 2)在一元前缀运算符后不加空格

Java编码规范,在您进行编码之前应该阅读的规范

大城市里の小女人 提交于 2020-03-02 04:36:59
本文转载于:http://www.web3d.com.cn/new/teach/java3d/2006/11/13/363276161.html Java编码规范 说明 1.1 为什么要有编码规范 编码规范对于程序员而言尤为重要,有以下几个原因: 一个软件的生命周期中,80%的花费在于维护。 几乎没有任何一个软件,在其整个生命周期中,均由最初的开发人员来维护。 编码规范可以改善软件的可读性,可以让程序员尽快而彻底地理解新的代码。 如果你将源码作为产品发布,就需要确任它是否被很好的打包并且清晰无误,一如你已构建的其它任何产品。 为了执行规范,每个软件开发人员必须一致遵守编码规范。每个人!!! 1.2版权声明 本文档反映的是Sun MicroSystems公司,Java语言规范中的编码标准部分。主要贡献者包括:Peter King,Patrick Naughton,Mike DeMoney,Jonni Kanerva,Kathy Walrath以及Scott Hommel。本文档现由Scott Hommel维护,有关评论意见请发至shommel@eng.sun.com 2. 文件名(File Names) 这部分列出了常用的文件名及其后缀。 2.1 文件后缀(File Suffixes) Java程序使用下列文件后缀: 文件类别 文件后缀 Java源文件 .java Java字节码文件

前端CSS规范整理-豆瓣的CSS规范

微笑、不失礼 提交于 2019-12-10 02:46:35
一、文件规范 1、文件均归档至约定的目录中。 具体要求通过豆瓣的CSS规范进行讲解: 所有的CSS分为两大类:通用类和业务类。通用的CSS文件,放在如下目录中: 基本样式库 /css/core 通用UI元素样式库 /css/lib JS组件相关样式库 /css/ui 业务类的CSS是指和具体产品相关的文件,放在如下目录中: 读书 /css/book/ 电影 /css/movie/ 音乐 /css/music/ 社区 /css/sns/ 小站 /css/site/ 同城 /css/location/ 电台 /css/radio/ 外联CSS文件适用于全站级和产品级通用的大文件。内联CSS文件适用于在一个或几个页面共用的CSS。另外一对具体的CSS进行文档化的整理。如: util-01 reset /css/core/reset.css util-02 通用模块容器 /css/core/mod.css ui-01. 喜欢按钮 /css/core/fav_btn.css ui-02. 视频/相册列表项 /css/core/media_item.css ui-03. 评星 /css/core/rating.css ui-04. 通用按钮 /css/core/common_button.css ui-05. 分页 /css/core/pagination.css ui-06. 推荐按钮

DIV+CSS规范命名大全集合

拟墨画扇 提交于 2019-12-06 11:44:38
网页制作中规范使用 DIV+CSS 命名规则,可以改善优化功效特别是团队合作时候可以提供合作制作效率,具体 DIV CSS命名规则CSS命名大全 内容篇。 常用DIV+CSS命名大全集合,即CSS命名规则 DIV CSS命名目录 命名规则说明 重要CSS命名 CSS命名参考表 命名技巧 我们开发 CSS+DIV 网页(Xhtml)时候,比较困惑和纠结的事就是 CSS命名 ,特别是新手不知道什么地方该如何命名,怎样命名才是好的方法。 一、命名规则说明: - TOP 1)、所有的命名最好都小写 2)、属性的值一定要用双引号("")括起来,且一定要有值如class="divcss5",id="divcss5" 3)、每个标签都要有开始和结束,且要有正确的层次,排版有规律工整 4)、空元素要有结束的tag或于开始的tag后加上"/" 5)、表现与结构完全分离,代码中不涉及任何的表现元素,如style、font、bgColor、border等 6)、<h1>到<h5>的定义,应遵循从大到小的原则,体现文档的结构,并有利于搜索引擎的查询。 7)、给每一个表格和表单加上一个唯一的、结构标记id 8)、给图片加上alt标签 9)、尽量使用英文命名原则 10)、尽量不缩写,除非一看就明白的单词 DIVCSS5给大家介绍常见CSS命名和 DIV CSS 命名方法。 二