zoukankan      html  css  js  c++  java
  • 基础编程规范

    编程规范

    Ø 注释

    1)   #: 个人注释

    2)  """ 注释 """:另一种是 docstrings表明如何使用这个包、模块、类、函数(方法),甚至包括使用示例和单元测试。推荐对每一个包、模块、类、函数(方法)写 docstrings。

    示例: 函数或者类或者模块的doc

    def python_class():

        """ my first function """

    print python_class.__doc__    

    Ø 缩进

    1) tab :建议设置  tab == 4个空格(一般编辑器都是这样)

    linux中vim设置方法

    打开 ~/.vimrc 输入下边内容

    set tabstop=4

    set softtabstop=4

    set shiftwidth=4

    set expandtab

    2) 空格:也建议采用4个空格

    作用:缩进作为语法的一部分融入python语言中,python中通过缩进来确定代码块的层次;

    最终建议 使用tab, 设置tab4个空格

    Ø 空行

    目的:增加代码的可读性,使代码看起来更加清晰

    参考准则:

    1) 模块中类和函数之间空两行

    2) 在类中的方法(类中的函数)之间空一行;

    3) 在函数中的逻辑段落间加空行,即把相关的代码紧凑写在一起,作为一个逻辑段落,段落间以空行分隔;

    4  import 不同种类的模块间加空行;参考五

    Ø 命名

    对象 库、模块、类、函数、变量、常量

    一句话google命名规范): 类使用驼峰式,其他的都采用小写+下划线_

    1)库  小写一个名词(项目名)

    2)模块 小写,直接连接或者用 “_”      python_class

    module.py     define_module.py

    3) 驼峰式,首字母大写,不使用下划线连接单词。

    class ThisIsAClass(object):

        pass

    4)函数 小写,用”_” 隔开

    def this_is_a_func():

    pass

    5)变量 小写,用”_” 隔开

    this_is_a_variable = 1

    变量名不应带有类型信息,因为 Python 是动态类型语言。

    6)常量:常量名所有字母大写,由下划线连接各个单词,如THIS_IS_A_CONSTANT = 1

     

     

    Ø import

    import 语句有以下几个原则需要遵守:

    1) import 的次序,先 import Python 标准库,再 import 第三方模块,最后 import 自己开发的项目中的其它模块;这几种模块中用空行分隔开来

    2) 一条 import 语句 尽量只import 一个模块

    3) 当import文件的时候: 先找当前目录, 进而在找python安装的目录

  • 相关阅读:
    关于easuiy中的datetimebox与数据库中的时间的交互的使用
    datagrid的getdata和getrows
    easyui中的datagrid的数据加载的问题
    数据库中的数据在datagrid显示footer的显示
    关于网页间传递汉字出现乱码的情况
    使用OpenCL(二) 设备上下文
    使用OpenCL
    复合、源文件组织、类别
    内存管理
    Foundation Kit介绍
  • 原文地址:https://www.cnblogs.com/liang545621/p/7523461.html
Copyright © 2011-2022 走看看