python代码文件结构和项目目录结构

python项目的代码结构包括，单个python文件的结构和整个项目的目录结构。

一、文件结构

打开一个标准的python文件，我们发现有如下的片段，对每一个片段存在的意义进行分析，就可以总结出python文件的一般结构。参考如下：

# /usr/bin/env/ python     　　　　    # (1) 起始行
# -*- coding: utf-8 -*-               # (2) 声明文件中的编码格式，在使用中文过程中，最好使用utf-8
"this is a test module"               # (3) 模块文档(文档字符串)
import sys
import os                             # (4) 模块导入

debug = True                          # (5) (全局)变量定义
class FooClass(object):
    'foo class'
    pass                              # (6) 类定义(若有)
def test():
    'test function'
    foo = FooClass()

    if debug:
        print('ran test()')           # (7) 函数定义(若有)

if __name__ == '__main__':            # (8) 主程序
    test()

1、文件头注释：一般包括起始行，编码格式，模块文档说明

2、import：引入第三方的包或者模块名，调用其变量，函数和类。

import跟C/C++中的#include作用有点类似，