• 基础编程规范


    编程规范

    Ø 注释

    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安装的目录

  • 相关阅读:
    android 关于双卡设置
    android apk反编译和odex转dex
    Android中获取系统内存信息以及进程信息ActivityManager的使用(一)
    ubuntu banshee music
    linux 查看文件夹大小
    嵌入式Linux学习笔记之GPIO接口
    Android中MediaButtonReceiver广播监听器的机制分析
    在Ubuntu中VirtualBox下xp使用usb设备
    beyond compare 与git diff整合
    Linux学习笔记一 Linux基础知识认知以及初识Linux下C编程入门
  • 原文地址:https://www.cnblogs.com/liang545621/p/7523461.html
Copyright © 2020-2023  润新知