`

python 变量命名规范

 
阅读更多
出自:http://www.diybl.com/course/3_program/python/20111130/563643.html
模块名:
小写字母,单词之间用_分割
ad_stats.py

包名:
和模块名一样

类名:
单词首字母大写
AdStats
ConfigUtil

全局变量名(类变量,在java中相当于static变量):
大写字母,单词之间用_分割
NUMBER
COLOR_WRITE

普通变量:
小写字母,单词之间用_分割
this_is_a_var

实例变量:
以_开头,其他和普通变量一样
_price   
_instance_var

私有实例变量(外部访问会报错):
以__开头(2个下划线),其他和普通变量一样
__private_var

专有变量:
__开头,__结尾,一般为python的自有变量,不要以这种方式命名
__doc__
__class__

普通函数:
和普通变量一样:
get_name()
count_number()
ad_stat()

私有函数(外部访问会报错):
以__开头(2个下划线),其他和普通函数一样
__get_name()
————————————————————————————————————————————————————————————————————
文件名
全小写,可使用下划线

应该是简短的、小写的名字。如果下划线可以改善可读性可以加入。如mypackage。
模块
与包的规范同。如mymodule。

总是使用首字母大写单词串。如MyClass。内部类可以使用额外的前导下划线。

函数&方法
函数名应该为小写,可以用下划线风格单词以增加可读性。如:myfunction,my_example_function。
*注意*:混合大小写仅被允许用于这种风格已经占据优势的时候,以便保持向后兼容。
函数和方法的参数
总使用“self”作为实例方法的第一个参数。总使用“cls”作为类方法的第一个参数。
如果一个函数的参数名称和保留的关键字冲突,通常使用一个后缀下划线好于使用缩写或奇怪的拼写。
全局变量
对于from M import *导入语句,如果想阻止导入模块内的全局变量可以使用旧有的规范,在全局变量上加一个前导的下划线。
*注意*:应避免使用全局变量
变量
变量名全部小写,由下划线连接各个单词。如color = WHITE,this_is_a_variable = 1
*注意*:
1.不论是类成员变量还是全局变量,均不使用 m 或 g 前缀。
2.私有类成员使用单一下划线前缀标识,多定义公开成员,少定义私有成员。
3.变量名不应带有类型信息,因为Python是动态类型语言。如 iValue、names_list、dict_obj 等都是不好的命名。
常量
常量名所有字母大写,由下划线连接各个单词如MAX_OVERFLOW,TOTAL。
异常
以“Error”作为后缀。
缩写
命名应当尽量使用全拼写的单词,缩写的情况有如下两种:
1.常用的缩写,如XML、ID等,在命名时也应只大写首字母,如XmlParser。
2.命名中含有长单词,对某个单词进行缩写。这时应使用约定成俗的缩写方式。
例如:
function 缩写为 fn
text 缩写为 txt
object 缩写为 obj
count 缩写为 cnt
number 缩写为 num,等。
前导后缀下划线
一个前导下划线:表示非公有。
一个后缀下划线:避免关键字冲突。
两个前导下划线:当命名一个类属性引起名称冲突时使用。
两个前导和后缀下划线:“魔”(有特殊用途)对象或者属性,例如__init__或者__file__。绝对不要创造这样的名字,而只是使用它们。
*注意*:关于下划线的使用存在一些争议。
Python 用下划线作为变量前缀和后缀指定特殊变量。

_xxx      不能用'from module import *'导入
__xxx__ 系统定义名字
__xxx    类中的私有变量名

核心风格:避免用下划线作为变量名的开始。

因为下划线对解释器有特殊的意义,而且是内建标识符所使用的符号,我们建议程序员避免用下划线作为变量名的开始。一般来讲,变量名_xxx被看作是“私有的”,在模块或类外不可以使用。当变量是私有的时候,用_xxx 来表示变量是很好的习惯。因为变量名__xxx__对Python 来说刑厥夂澹杂谄胀ǖ谋淞坑Φ北苊庹庵置绺瘛?br>
"单下划线" 开始的成员变量叫做保护变量,意思是只有类对象和子类对象自己能访问到这些变量;
"双下划线" 开始的是私有成员,意思是只有类对象自己能访问,连子类对象也不能访问到这个数据。

以单下划线开头(_foo)的代表不能直接访问的类属性,需通过类提供的接口进行访问,不能用“from xxx import *”而导入;以双下划线开头的(__foo)代表类的私有成员;以双下划线开头和结尾的(__foo__)代表python里特殊方法专用的标识,如 __init__()代表类的构造函数。
特定命名方式
主要是指 __xxx__ 形式的系统保留字命名法。项目中也可以使用这种命名,它的意义在于这种形式的变量是只读的,这种形式的类成员函数尽量不要重载。如
class Base(object):
def __init__(self, id, parent = None):
self.__id__ = id
self.__parent__ = parent
def __message__(self, msgid):
# …略
其中 __id__、__parent__ 和 __message__ 都采用了系统保留字命名法。
附:Google Python命名规范
module_name, package_name, ClassName, method_name, ExceptionName, function_name, GLOBAL_VAR_NAME, instance_var_name, function_parameter_name, local_var_name.
————————————————————————————————————————————————————————
from:http://hi.baidu.com/kxw102/blog/item/212e9f3859202fe33b87ce4b.html
理解Python命名机制

引子
我热情地邀请大家猜测下面这段程序的输出:
class A(object):
       def __init__(self):
              self.__private()
              self.public()
       def __private(self):
              print 'A.__private()'
       def public(self):
              print 'A.public()'
class B(A):
       def __private(self):
              print 'B.__private()'
       def public(self):
              print 'B.public()'
b = B()

初探
正确的答案是:
A.__private()
B.public()
如果您已经猜对了,那么可以不看我这篇博文了。如果你没有猜对或者心里有所疑问,那我的这篇博文正是为您所准备的。
一切由为什么会输出“A.__private()”开始。但要讲清楚为什么,我们就有必要了解一下Python的命名机制。
据 Python manual,变量名(标识符)是Python的一种原子元素。当变量名被绑定到一个对象的时候,变量名就指代这个对象,就像人类社会一样,不是吗?当变 量名出现在代码块中,那它就是本地变量;当变量名出现在模块中,它就是全局变量。模块相信大家都有很好的理解,但代码块可能让人费解些。在这里解释一下:
代码块就是可作为可执行单元的一段Python程序文本;模块、函数体和类定义都是代码块。不仅如此,每一个交互脚本命令也是一个代码块;一个脚本文件也是一个代码块;一个命令行脚本也是一个代码块。
接 下来谈谈变量的可见性,我们引入一个范围的概念。范围就是变量名在代码块的可见性。如果一个代码块里定义本地变量,那范围就包括这个代码块。如果变量定义 在一个功能代码块里,那范围就扩展到这个功能块里的任一代码块,除非其中定义了同名的另一变量。但定义在类中的变量的范围被限定在类代码块,而不会扩展到 方法代码块中。

迷踪
据上节的理论,我们可以把代码分为三个代码块:类A的定义、类B的定义和变量b的定义。根据类定义,我们知道代码给类A定义了三个成员变量(Python的函数也是对象,所以成员方法称为成员变量也行得通。);类B定义了两个成员变量。这可以通过以下代码验证:
>>> print '\n'.join(dir(A))
_A__private
__init__
public
>>> print '\n'.join(dir(B))
_A__private
_B__private
__init__
public
咦,为什么类A有个名为_A__private的 Attribute 呢?而且__private消失了!这就要谈谈Python的私有变量轧压了。

探究
懂 Python的朋友都知道Python把以两个或以上下划线字符开头且没有以两个或以上下划线结尾的变量当作私有变量。私有变量会在代码生成之前被转换为 长格式(变为公有)。转换机制是这样的:在变量前端插入类名,再在前端加入一个下划线字符。这就是所谓的私有变量轧压(Private name mangling)。如类A里的__private标识符将被转换为_A__private,这就是上一节出现_A__private和 __private消失的原因了。
再讲两点题外话:
一是因为轧压会使标识符变长,当超过255的时候,Python会切断,要注意因此引起的命名冲突。
二是当类名全部以下划线命名的时候,Python就不再执行轧压。如:
>>> class ____(object):
       def __init__(self):
              self.__method()
       def __method(self):
              print '____.__method()'
>>> print '\n'.join(dir(____))
__class__
__delattr__
__dict__
__doc__
__getattribute__
__hash__
__init__
__method              # 没被轧压
__module__
__new__
__reduce__
__reduce_ex__
__repr__
__setattr__
__str__
__weakref__
>>> obj = ____()
____.__method()
>>> obj.__method()      # 可以外部调用
____.__method()
现在我们回过头来看看为什么会输出“A.__private()”吧!

真相
相信现在聪明的读者已经猜到答案了吧?如果你还没有想到,我给你个提示:真相跟C语言里的宏预处理差不多。
因为类A定义了一个私有成员函数(变量),所以在代码生成之前先执行私有变量轧压(注意到上一节标红的那行字没有?)。轧压之后,类A的代码就变成这样了:
class A(object):
       def __init__(self):
              self._A__private()          # 这行变了
              self.public()
       def _A__private(self):           # 这行也变了
              print 'A.__private()'
       def public(self):
              print 'A.public()'
是不是有点像C语言里的宏展开啊?
因为在类B定义的时候没有覆盖__init__方法,所以调用的仍然是A.__init__,即执行了self._A__private(),自然输出“A.__private()”了。
下面的两段代码可以增加说服力,增进理解:
>>> class C(A):
       def __init__(self):          # 重写__init__,不再调用self._A__private
              self.__private()       # 这里绑定的是_C_private
              self.public()
       def __private(self):
              print 'C.__private()'
       def public(self):
              print 'C.public()'
>>> c = C()
C.__private()
C.public()
############################
>>> class A(object):
       def __init__(self):
              self._A__private()   # 调用一个没有定义的函数,Python会把它给我的 ^_^~
              self.public()
       def __private(self):
              print 'A.__private()'
       def public(self):
              print 'A.public()'
>>>a = A()
A.__private()
A.public()
分享到:
评论
3 楼 hymzjsw 2016-11-13  
      
2 楼 greybeard 2012-08-26  
xiaoyao3857 写道
怎么看着一大堆,似乎中间有些东西重复说了吧

这个不是我整理的,是copy网上的。应该没多少重复的吧,总结的还蛮好的,不过自己取自己需要的,没必要一定要按照这样的标准。
1 楼 xiaoyao3857 2012-08-23  
怎么看着一大堆,似乎中间有些东西重复说了吧

相关推荐

    python变量命名规范.pdf

    ### Python 变量命名规范详解 #### 概述 Python作为一种高级编程语言,因其简洁、易读性高的特点被广泛应用于各个领域。...希望本文能够帮助您更好地掌握Python变量命名规范,进而在实际开发中灵活应用。

    python 变量命名查询小工具

    1. **命名规范检查**:根据Python的PEP 8风格指南,对输入的变量名进行检查,确保它们遵循下划线分隔的驼峰式命名规则(如`my_variable_name`),或者小写字母和下划线(如`my_variable_name`)的约定。此外,它还...

    python变量命名规范[总结].pdf

    ### Python变量命名规范详解 #### 一、概述 在Python编程中,良好的命名规范能够显著提升代码的可读性和维护性。本篇文章基于文件“python变量命名规范[总结].pdf”所提供的内容,深入探讨了Python中各类命名的...

    python 变量命名规范1

    下面将详细讲解Python中的变量命名规则及其背后的逻辑。 首先,变量命名的基本原则是清晰易读,避免使用具有误导性的名字。在Python中,变量名区分大小写,因此可以通过大小写来区分不同的单词。推荐使用小写字母和...

    Python变量的命名-Python中的变量命名规则

    Python由荷兰数学和计算机科学研究学会的吉多·范罗苏姆于1990年代初设计,Python提供了高效的高级数据结构,还能简单有效地面向对象编程。Python语法和动态类型,以及解释型语言的本质,使它成为多数平台上写脚本和...

    和孩子一起学习python之变量命名规则

    变量命名规则 下面是关于变量名(也称为标识符)的一些规则 必须以一个字母或一个下划线字符开头。后面可以使用一个字母、数字或下划线字符的序列,长度不限。 字母可以是大写或小写,大小写是不同的。也就是说,...

    python变量.pdf

    ### Python变量知识点详解 #### 变量概述 变量在Python编程中扮演着极其重要的角色,它们是用于存储数据值的标识符。理解变量的概念、命名规则以及如何使用它们对于掌握Python编程至关重要。 #### 注释 - **作用**...

    Python代码规范和命名规范

    Python 代码规范和命名规范是 Python 开发者所必须遵守的规则,以保证代码的可读性、可维护性和一致性。下面是 Python 代码规范和命名规范的详细说明: 编码 * 文件一律使用 UTF-8 编码,以避免字符编码问题。 * ...

    《信息采集—Python变量》教学设计.pdf

    在任务二中,学生学习变量命名的规则,如变量名不能以数字开头,不能使用Python保留字,并通过实际编写代码进行练习。此外,还探索了变量值的修改,展示了变量的动态性。 在拓展延伸部分,引入了表达式,让学生探讨...

    《python编程实践》第2章练习题及解答作者:陈波,刘慧君

    通过本章节的学习,你将掌握 Python 变量命名规则、字符串操作、基本数据类型的使用等知识。 一、变量命名规则 在 Python 中,变量命名规则是非常重要的。变量名可以由字母、数字和下划线组成,但不能以数字开头。...

    python变量以及数据类型

    **1.3 变量的命名规则** - **允许使用中文**,但通常不推荐。 - **可以包含数字**,但数字不能位于变量名的开头。 - **只能使用字母、数字和下划线** 组合。 - **严格区分大小写**,如 `name` 和 `Name` 是两个不同...

    变量命名规则(Python)

    以下是对Python变量命名规则的详细说明: 1. **弱类型特性**: Python是一种弱类型语言,这意味着在声明变量时,你不需要指定变量的类型。变量的类型会根据赋给它的值自动确定。例如,你可以将一个字符串赋给一个...

    Python语言基础:变量.pptx

    其次,变量名中不能包含空格和标点符号,如`ClassName`这样的命名是不合法的。另外,避免使用Python的关键字作为变量名,可以利用`keyword.kwlist`查看所有的Python关键字,例如: ```python import keyword print...

    试题青少年编程等级考试Python编程一级试卷2word练习.pdf

    19. Python 变量命名规范:合法的变量名可以由字母、数字和下划线组成,但不能以数字开头,不能是Python的关键字。 20. Python 代码执行:没有给出具体代码,无法确定a和b的值,但根据描述,它们应该是变量名。 21...

    python变量命名的7条建议

    以下是关于Python变量命名的7条建议: 1. **使用有意义且可读的变量名**:避免使用难以理解的缩写或符号,例如`ymdstr`,而应使用如`current_date`这样的名称,使得阅读者能一眼看出变量的用途。 2. **保持同类...

    Python 变量类型及命名规则介绍

    复制代码 代码如下:# 例:使用变量a = 10b = 20print a + b>>> 30 # 输出a加b的值a = ‘hello’b = ‘python’print a + ‘ ‘ + b>>> hello python # 输出a加b的值 上面几个例子是使用变量进行运算,python的变量...

    自主创作的代码编写变量命名工具

    标题中的“自主创作的代码编写变量命名工具”指的是一个由个人开发者设计的程序,它能够帮助程序员在编写代码时自动生成符合规范的变量名。这个工具可能是为了提高编程效率,减少手动命名的时间,并确保遵循良好的...

    一文轻松掌握python语言命名规则(规范)

    一、python变量名命名的硬性规则 1.1. 变量名大小写敏感 python变量名区分大小写,也就是Student和student在python语言中代表两个不同的名字。 1.2. python的变量名字中可以包含英文、下划线、数字,但是不能以数字...

    高中信息技术期学科Python语言基础期中考试word.docx

    15. Python 变量命名规范:第十五题中,A 选项是 Python 的保留关键字;B 选项以数字开头;C 选项包含特殊字符;D 选项符合命名规则。答案是 D._abc88。 16. Python 程序分析: - 在程序 1 中,`i+=1` 表示将变量...

Global site tag (gtag.js) - Google Analytics