Python基础 – 命名规范

一,包名、模块名、局部变量名、函数名

全小写+下划线式驼峰

example:this_is_var

二,全局变量

全大写+下划线式驼峰

example:GLOBAL_VAR

三,类名

首字母大写式驼峰

example:ClassName()

四,关于下划线

以单下划线开头,是弱内部使用标识,from M import * 时,将不会导入该对象(python 一切皆对象)。

以双下划线开头的变量名,主要用于类内部标识类私有,不能直接访问。模块中使用见上一条。

双下划线开头且双下划线截尾的命名方法尽量不要用,这是标识

example for 1:

module_1 模块中定义变量 var_1, _var_2, __var_3

#module_1

var_1

_var_2

__var_3

module_2 模块中代码如下:

1
2
3
4
5
6
7
8
9
#module_2_error
 '''
 以下划线开头的变量不会别导入
 '''
  from module_1import *
   
  print var_1
  print _var_2 #将报错
  print __var_3 #将报错

执行到第6,7行将会报错,因为凡是以下划线开头的对象都不会被导入。

既然是弱内部使用标识,就还是有使用办法的,只需单独导入即可:

1
2
3
4
5
6
7
8
9
#module_2_solution
  
 from module_1import *  # 导入所有的不是下划线开头的对象
  
 from module_1import _var_2, __var_3# 显式导入下划线开头的对象
  
 print var_1
 print _var_2# 不会报错
 print __var_3 # 不会报错

example for 2:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
#module_error
 '''
 双下划线开头的变量不能被直接访问
 '''
  
 class MyClass():
     def __init__(self):
         self.var_1= 1
         self._var_2= 2
         self.__var_3= 3
      
 if __name__=="__main__":
     obj= MyClass()
     print obj.var_1
     print obj._var_2
     print obj.__var_3 # 这里将会出错

需要定义函数来获取双下划线开头的变量

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
#module_solution
 
'''
需要定义函数来获取双下划线开头的变量
'''
 
class MyClass():
    def __init__(self):
        self.var_1= 1
        self._var_2= 2
        self.__var_3= 3
         
    def get_var_3(self):
        return self.__var_3
         
     
 
if __name__=="__main__":
    obj= MyClass()
    print obj.var_1
    print obj._var_2
    print obj.get_var_3() # 不会再报错

四,其他要注意的

不要像c等语言里面一样去用开头字母标识变量类型(如 iValue),因为python在解释的时候才确定类型。

因为异常也是一个类,所以遵守类的命名规则。此外,如果异常实际上指代一个错误的话,应该使用“Error”做后缀。

命名应当尽量使用全拼写的单词,缩写的情况有如下两种:常用的缩写,如XML、ID等,在命名时也应只大写首字母,如XmlParser。命名中含有长单词,对某个单词进行缩写。这时应使用约定成俗的缩写方式。例如:function 缩写为 fn, text 缩写为 txt, object 缩写为 obj, count 缩写为 cnt, number 缩写为 num 等。

类实例方法第一个参数使用self, 类方法第一个参数使用cls

© 版权声明
THE END
喜欢就支持一下吧
点赞14 分享
评论 抢沙发
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片

    暂无评论内容