当前位置: 首页 > news >正文

python的统一编码规范

请注意这一点:没有编码规范的代码没有阅读价值,也更谈不上复用。

目前业界比较流行的Python的编码规范目前主要有PEP8的编程、Google的编码风格、Python Guide和Pocoo StyleGuide等等,我认为无论是哪一种编码规范和风格,最重要的是要在团队中有一套统一或者近乎一致的编码规范和风格,这样才能确保协作效率和降低沟通成本。目前我所在的团队并没有一套规范,那么这个伟大的任务又要落在我手里来实现啦,哇哈哈:-D。

先说明一下,设计这套统一编码规范的原则只有一个:Simple is the best,简单实用是核心指导原则,编码规范要符合编码习惯和提升代码可读性。这套编码规范是基于PEP8规范的,但是同时参考Google的编码风格和大神编写的"Strunk & White"风格。

命名

文件名、包名、模块名:全小写,使用下划线可以改善可读性可以加入,如my_package。

:总是使用首字母大写单词串。如MyClass。

函数、方法:函数名应该为小写,可以用下划线风增加可读性,如my_example_function。

变量:小写,尽量避免单字母变量,尽量让变量有意义。

常量:要求全部字幕大写,可以用下划线风增加可读性,如GLOBAL_VAR_NAME。

内部(Internal):使用(_)开头表示模块变量或函数是protected 的(使用import * from时不会包含);使用(__)开头表示实例变量或方法表示类内私有,类实例不能调用。

缩写:名中含有长单词,对某个单词进行缩写。这时应使用约定成俗的缩写方式。 例如:function 缩写为 fn;text 缩写为 txt ;object 缩写为 obj ;count 缩写为 cnt;number 缩写为 num 等。

布局

最重要的话写在第一句:如果懒得跟我一样的话,使用pycharm IDE用快捷键Ctrl+Alt+L就可以完成统一的代码布局。

在不使用这个IDE或者忘了用快捷键的情况下,请注意以下统一的代码布局:

代码长度:每行不超过80个字符。这一点pycharm没有这么严格,但是希望大家尽力做到,这样确保其他同事可以轻松愉快地阅读每一行代码。

空行:用两行空行分割顶层函数和类的定义,类内方法的定义用单个空行分割。

缩进:使用4个空格作为一个缩进层次,尽量不要用8个空格。

分号:不要使用分号,尽管是用了也没有错。

括号:括号使用原则是越少越好,不要在返回语句或者条件语句中使用括号,例如:

image

image

空格(请尽量不要用制表符TAB,如果用了请保持一致):

括号内不使用空格;

image

不在逗号和冒号前使用空格,在其后面添加(跟英文写作一样);

image

二元操作符 【赋值(=), 比较(==, <, >, !=, <>, <=, >=, in, notin, is, is not), 布尔(and, or, not)】两边都使用空格,

image

参数列表里不要带空格

image

以上截图来自《Google python style guide》

注释

python单行注释用#字符开头即可注释后面的内容,对于重要语句进行注释包括解释说明和提醒的作用。 python多行注释可以用’’’或者”””开头并以相同的用’’’或者”””结尾即可注释多行语句。

别说明: python的方法内置对象doc String ,它可以用于模块、函数和类的描述,在写方法的时候,只要在方法声明下面进行多行注释。在引用或者使用的场景下,可以通过dir或者help方法可以查看该方法的使用帮助。python的方法注释可以参照下图,pycharm支持自动生成注释,比较方便。

2012120417151729.png

Python 有一种独一无二的的注释方式: 使用文档字符串. 文档字符串是包, 模块, 类或函数里的第一个语句. 这些字符串可以通过对象的__doc__成员被自动提取, 并且被pydoc 所用. (你可以在你的模块上运行pydoc 试一把, 看看它长什么样). 我们对文档字符串的惯例是使用三重双引号. 一个文档字符串应该这样组织: 首先是一行以句号, 问号或惊叹号结尾的概述. 接着是一个空行. 接着是文档字符串剩下的部分, 它应该与文档字符串的第一行的第一个引号对齐。注意上图中的函数注释,文档字符串应该包含函数做什么, 以及输入和输出的详细描述. 通常, 不应该描述”怎么做”, 除非是一些复杂的算法. 对于技巧性的代码, 块注释或者行内注释是最重要的. 文档字符串应该提供足够的信息, 当别人编写代码调用该函数时, 他不需要看一行代码, 只要看文档字符串就可以了. 应该给参数单独写文档. 在冒号后跟上解释,

导入

可以使用两种导入的方法:

1.使用 import x 来导入包和模块。

2.使用 form x import y , 其中x 是包前缀, y 是不带前缀的模块名。

在后面讲述的common-lib库中,建议大家使用from common-lib import *这样的导入,在这个自定义库的__init__.py文件中已经定义了哪些可以导入哪些不需要导入。比较方便。

使用上述的导入方法的时候,要使用绝对路径而非相对路径,避免重复导入。

Main入口

要求所有新建的py文件都要有Main的入口,且必须总是检查该导如的主程序是否被执行。

Pycharm支持python代码模板,建议大家使用这个模板。

#-*- encoding:UTF-8 -*-
from __future__ import division
import sys

__author__ = '$USER'
def main():
    pass

if __name__ == '__main__':
    reload(sys)
    print "START: system-encoding[%s]"%sys.getdefaultencoding()
    main()

这个代码执行的时候先检查系统的编码,这个TIP是我踩过很多坑之后的教训,这样可以让你每次都知道当前程序运行的编码。

 

参考文档

《Google-Python-Style-Guide》

《Python开发编码规范(PEP8)》

The Elements of Python Style


转载于:https://www.cnblogs.com/kendrick/p/5132274.html

相关文章:

  • c# 反射
  • 使用AutoCompleteTextView和AsyncTask 检索城市
  • python之路(二)函数
  • Linux下设置定期执行脚本
  • Linux下安装配置MongoDB数据库
  • Zabbix服务器端安装过程(含centos 7.1安装 zabbix3.0.8的故障排除)
  • 数学之路-python计算实战(2)-初遇pypy
  • linux --vsftpd虚拟用户登录时 530 Login incorrect排错
  • 昨天要成为反弹一日游?关键看下午了
  • Microsoft Azure Linux 多网卡配置
  • 细数JDK里的设计模式转
  • 如何在 Tornado 中实现 Middleware
  • Cannot run program git.exe: CreateProcess error=
  • 自建博客随想录
  • JAVA简单介绍1
  • es6--symbol
  • Hibernate最全面试题
  • java小心机(3)| 浅析finalize()
  • js递归,无限分级树形折叠菜单
  • leetcode46 Permutation 排列组合
  • Lsb图片隐写
  • open-falcon 开发笔记(一):从零开始搭建虚拟服务器和监测环境
  • PHP的Ev教程三(Periodic watcher)
  • PHP的类修饰符与访问修饰符
  • Ruby 2.x 源代码分析:扩展 概述
  • Vue2.x学习三:事件处理生命周期钩子
  • WinRAR存在严重的安全漏洞影响5亿用户
  • 百度地图API标注+时间轴组件
  • 不上全站https的网站你们就等着被恶心死吧
  • 浮动相关
  • 更好理解的面向对象的Javascript 1 —— 动态类型和多态
  • 关键词挖掘技术哪家强(一)基于node.js技术开发一个关键字查询工具
  • 检测对象或数组
  • 盘点那些不知名却常用的 Git 操作
  • 前端技术周刊 2019-01-14:客户端存储
  • 前端每日实战 2018 年 7 月份项目汇总(共 29 个项目)
  • 如何在 Tornado 中实现 Middleware
  • 时间复杂度与空间复杂度分析
  • 数组大概知多少
  • 一个6年java程序员的工作感悟,写给还在迷茫的你
  • 中国人寿如何基于容器搭建金融PaaS云平台
  • ​马来语翻译中文去哪比较好?
  • (20050108)又读《平凡的世界》
  • (C++17) optional的使用
  • (三)Hyperledger Fabric 1.1安装部署-chaincode测试
  • (四) Graphivz 颜色选择
  • (一)搭建springboot+vue前后端分离项目--前端vue搭建
  • (译) 函数式 JS #1:简介
  • (转)C语言家族扩展收藏 (转)C语言家族扩展
  • (转载)深入super,看Python如何解决钻石继承难题
  • .cn根服务器被攻击之后
  • .NET Core中的去虚
  • .NET(C#、VB)APP开发——Smobiler平台控件介绍:Bluetooth组件
  • .NET中的Exception处理(C#)
  • .Net中的集合