python 中变量的命名方法

从网上找到django中python的命名规范

Python  规范

代码的布局

 编码

   全部的Python脚本文件都应在文件头标上“# -*- coding:utf-8 -*-”。

 缩进

4个空格一个缩进层次  

空行

适当的空行有利于增长代码的可读性，加空行能够参考以下几个准则：

(1) 在类、函数的定义间加空行；

(2) 在import不一样种类的模块间加工行；

(3) 在函数中的逻辑段落间加空行，即把相关的代码紧凑写在一块儿，做为一个逻辑段落，段落间以空行分隔

换行

       语句比较长，一行写不下的状况下使用

1. 在括号（包括圆括号、方括号和花括号）内换行，如：
   class Edit(CBase):
       def __init__(self, parent, width,
                   font = FONT, color = BLACK, pos = POS, style = 0):
   或：
   very_very_very_long_variable_name = Edit(parent, \
                                                            width, \
                                                             font, \
                                                             color, \
                                                             pos)
   若是行长到连第一个括号内的参数都放不下，则每一个元素都单独占一行：
   very_very_very_long_variable_name = ui.widgets.Edit( \
                                                      panrent, \
                                                      width, \
                                                      font, \
                                                      color, \
                                                      pos)
2. 在长行加入续行符强行断行，断行的位置应在操做符前，且换行后多一个缩进，以使维护人员看代码的时候看到代码行首便可断定这里存在换行，如：
   if color == WHITE or color == BLACK \
   or color == BLUE:       # 注意or操做符在新行的行首而不是旧行的行尾
       do_something(color);

命名约定

有许多不一样的命名风格。如下的有助于辨认正在使用的命名风格，独立于它们的做用。    如下的命名风格是众所周知的：

    b (单个小写字母)

    B (单个大写字母)

    Lowercase（小写）

    lower_case_with_underscores（有下划线的小写）

    UPPERCASE（大写）

UPPER_CASE_WITH_UNDERSCORES（有下划线的大写）

应避免的名字。永远不要用字符‘l’(小写字母el(就是读音，下同))，‘O’(大写字母oh)，或‘I’(大写字母eye)做为单字符的变量名。在某些字体中这些字符不能与数字1和0分辨。试着在使用‘l’时用‘L’代替。

 

 常量
常量名全部字母大写，由下划线链接各个单词，如：
WHITE = 0XFFFFFF
THIS_IS_A_CONSTANT = 1

 

变量
变量名所有小写，由下划线链接各个单词，如：
color = WHITE
this_is_a_variable = 1
不管是类成员变量仍是全局变量，均不使用 m 或 g 前缀。私有类成员使用单一下划线前缀标识，多定义公开成员，少定义私有成员。
变量名不该带有类型信息，由于 Python 是动态类型语言。如 iValue、names_list、dict_obj 等都是很差的命名。

全局变量名

               这些约定和在函数中的同样。模块是被设计为经过“from M import *”来使用的，必须用一个下划线做全局变量(及内部函数和类)的前缀防止其被导出(exporting)。

 

函数
函数名的命名规则与变量名相同。

类
类名单词首字母大写，不使用下划线链接单词，也不加入 C、T 等前缀。如：
class ThisIsAClass(object):
    passs

模块
模块名所有小写，对于包内使用的模块，能够加一个下划线前缀，如：
module.py
_internal_module.py

包
包的命名规范与模块相同。

缩写
命名应当尽可能使用全拼写的单词，缩写的状况有以下两种：

1      命名中含有长单词，对某个单词进行缩写。这时应使用约定成俗的缩写方式，如去除元音、包含辅音的首字符等方式，例如：
function 缩写为 fn
text 缩写为 txt
object 缩写为 obj
count 缩写为 cnt
number 缩写为 num，等。
特定命名方式，主要是指 __xxx__ 形式的系统保留字命名法。项目中也可使用这种命名，它的意义在于这种形式的变量是只读的，这种形式的类成员函数尽可能不要重载。

异常名

若是模块对全部状况定义了单个异常，它一般被叫作“error”或“Error”。彷佛内建(扩展)的模块使用“error”(例如：os.error)，而Python模块一般用“Error” (例如：xdrlib.Error)。趋势彷佛是倾向使用CapWords异常名

语句
 import
     import 语句有如下几个原则须要遵照：

（1）import 的次序，先 import Python 内置模块，再 import 第三方模块，最后 import 本身开发的项目中的其它模块；这几种模块中用空行分隔开来。

（2） 一条 import 语句 import 一个模块。

（3）当从模块中 import 多个对象且超过一行时，使用以下断行法
from module import (obj1, obj2, obj3, obj4,
                                             obj5, obj6)

（4）不要使用 from module import *，除非是 import 常量定义模块或其它你确保不会出现命名空间冲突的模块。

2      分枝和循环
       对于分枝和循环，有以下几点须要注意的：

不要写成一行，如：
If !flg: pass 和 for i in xrange(10): print i都不是好代码，应写成
if !flg:
    pass
for i in xrange(10):
    print i

 

其它建议

    始终在这些二元运算符两边放置一个空格：赋值(=)， 比较(==，<，>，!=，<>，<=，      >=，in，not in，is，is not)，布尔运算 (and，or，not)。

    按你的见解在算术运算符周围插入空格。 始终保持二元运算符两边空格的一致。

    一些例子：

#!Python

          i = i+1

          submitted = submitted + 1

          x = x*2 - 1

          hypot2 = x*x + y*y

          c = (a+b) * (a-b)

          c = (a + b) * (a - b)

    不要在用于指定关键字参数或默认参数值的'='号周围使用空格，例如：

#!Python

          def complex(real， imag=0。0)：

              return magic(r=real， i=imag)

   

 

注释

以#号开头

同代码不一致的注释比没注释更差。当代码修改时，始终优先更新注释!注释应该是完整的句子，若是注释是一个短语或句子，首字母应该大写，除非他是一个以小写字母开头的标识符(永远不要修改标识符的大小写)。

    若是注释很短，最好省略末尾的句号。 

注释块

注释块一般应用于跟随着一些(或者所有)代码并和这些代码有着相同的缩进层次。注释块中每行以‘#’和一个空格开始(除非他是注释内的缩进文本)。注释块内的段落以仅含单个‘#’的行分割。注释块上下方最好有一空行包围(或上方两行下方一行，对一个新函数定义段的注释)。

# url(r'^mysite/', include('mysite.foo.urls')),

 # Uncomment the admin/doc line below to enable admin documentation:

# url(r'^admin/doc/', include('django.contrib.admindocs.urls')),

 

行内注释

    一个行内注释是和语句在同一行的注释，行内注释应该谨慎适用，行内注释应该至少用两个空格和语句分开，它们应该以'#'和单个空格开始。

        x = x+1                 # Increment x

    若是语意是很明了的，那么行内注释是没必要要的，事实上是应该被移除的。不要这样写：

        x = x+1                 # Increment x

        x = x+1                 # Compensate for border

    可是有时，这样是有益的：

        x = x+1                 # Compensate for border

继承的设计

始终要肯定一个类中的方法和实例变量是否要被公开。一般，永远不要将数据变量公开，除非你实现的本质上只是记录，人们几乎老是更喜欢代之给出一个函数做为类的界面(Python 2.2 的一些开发者在这点上作得很是漂亮)。

一样，肯定你的属性是否应为私有的。私有和非私有的区别在于模板将永远不会对原有的类(导出类)有效，然后者能够。你应该在大脑中就用继承设计好了你的类，私有属性必须有两个前导下划线，无后置下划线，非公有属性必须有一个前导下划线，无后置下划线，公共属性没有前导和后置下划线，除非它们与保留字冲突，在此状况下，单个后置下划线比前置或混乱的拼写要好，例如：class_优于klass。

最后一点有些争议：若是相比class_你更喜欢klass，那么这只是一致性问题。

 

设计建议

单个元素(singletons)的比较，如None 应该永远用：‘is’或‘is not’来作。当你本意是“if x is not None”时，对写成“if x”要当心。例如当你测试一个默认为None的变量或参数是否被设置为其它值时，这个值也许在布尔上下文(Boolean context)中是false！

基于类的异常老是好过基于字符串的异常。模块和包应该定义它们本身的域内特定的基异常类，基类应该是内建的Exception类的子类。还始终包含一个类的文档字符串。例如：

#!Python

        class MessageError(Exception)：

            """Base class for errors in the email package。"""

使用字符串方法(methods)代替字符串模块，除非必须向后兼容Python 2.0之前的版本。字符串方法老是很是快，并且和unicode字符串共用一样的API(应用程序接口)在检查前缀或后缀时避免对字符串进行切片。用startswith()和endswith()代替，由于它们是明确的而且错误更少。例如：

        No： if foo[：3] == 'bar'：

        Yes： if foo。startswith('bar')：

例外是若是你的代码必须工做在Python 1.5.2 (可是咱们但愿它不会发生！)，对象类型的比较应该始终用isinstance()代替直接比较类型，例如：

        No： if type(obj) is type(1)：

        Yes： if isinstance(obj， int)：

检查一个对象是不是字符串时，紧记它也多是unicode字符串！在Python 2.3，str和unicode有公共的基类，basestring，因此你能够这样作：

        if isinstance(obj， basestring)：

在Python 2.2类型模块为此定义了StringTypes类型，例如：

#!Python

        from types import StringTypes

        if isinstance(obj， StringTypes)：

在Python 2.0和2.1，你应该这样作：

#!Python

        from types import StringType， UnicodeType

        if isinstance(obj， StringType) or \

           isinstance(obj， UnicodeType) ：

对序列，(字符串，列表，元组)，使用空列表是false这个事实，所以“if not seq”或“if seq”比“if len(seq)”或“if not len(seq)”好。书写字符串文字时不要依赖于有意义的后置空格。这种后置空格在视觉上是不可辨别的，而且有些编辑器(特别是近来，reindent.py)会将它们修整掉。不要用==来比较布尔型的值以肯定是True或False(布尔型是Pythn 2.3中新增的)

        No： if greeting == True：

        Yes： if greeting：

 

        No： if greeting == True：

        Yes： if greeting：

Django  使用规范

（1）      模版规则：

在模版中，大括号里的关键词先后应该插入空格

如：{{ foo }}

而不是：{{foo}}

（2）      视图的规则：

在视图中，第一个参数应该写成request

如：def my_view (request , foo)：

           #…………………………

而不是：

     def my_view (foo ,request)：

            #…………………………

Model 规范

     （1）  里边的字段名应该小写，可使用下划线：

如：

 class Person(models.Model):

 first_name = models.CharField(max_length=20)

 last_name = models.CharField(max_length=40)

而不是：

  class Person(models.Model):

 Frst_name = models.CharField(max_length=20)

 LAST = models.CharField(max_length=40)

 

（2）两个class之间用空白行隔开

 

（3）model 内的classes 和 methods 应该采起如下的顺序（这些方法并非全部的class都要定义）：

全部的数据项的field

自定义的manager 属性

class Meta：
def __unicode__() ：

def save()

def get_absolute_url()

其余自定义的methods

若是给一个model field定义了可选择项，那么请将选择项定义为元组（内含不少元组--选择项），将选择项元组名称定义为所有大写，定义放在model的顶部 或者就在model 的上面。

例如，性别选择项GENDER_CHOICES这个名字为所有大写：
GENDER_CHOICES = (
    ('M', 'Male'),
    ('F', 'Female'),
)

django.conf.settings规范：

     （1）  settings.py中要使用相对路径：