Python学习之Python开发规范_python 开发规范

前言：我们在开发一些程序时（终端运行），应该遵循一些结构的规范，让你的系统更加专业。

1. 单文件程序 （当基于python开发简单应用时（一个py文件就能搞定），需要注意如下几点。）

"""
文件注释
"""
import sys # 内置
import re
import random 
 
import requests #第三方
 
from test import aaa #自定义
 
DB = "XXX" # 全局变量或者常量大写
 
 
def do_something(): #函数命名规范&函数功能注释
    """ 函数注释 """
 
    # TODO 待完成时，下一期实现xxx功能
    for i in range(10):
        pass
 
 
def run():
    """ 函数注释 """
 
    # 对功能代码进行注释
    text = input(">>>")
    print(text)
 
 
if __name__ == '__main__':
    run()

 2. 单可执行文件 (新创建一个项目，假设名字叫 【crm】，可以创建如下文件和文件夹来存放代码和数据。)

crm
├── app.py        文件，程序的主文件（尽量精简）
├── config.py     文件，配置文件（放相关配置信息，代码中读取配置信息，如果想要修改配置，即可以在此修改，不用再去代码中逐一修改了）# 也可叫settings.py
├── db            文件夹，存放数据
├── files         文件夹，存放文件
├── src           包，业务处理的代码
└── utils         包，公共功能

 3. 多可执行文件(新创建项目，假设名称叫【killer】，可以创建如下文件和文件夹来存放代码和数据。)

killer
├── bin					文件夹，存放多个主文件（可运行）
│   ├── app1.py
│   └── app2.py
├── config              包，配置文件
│   ├── __init__.py
│   └── settings.py
├── db                  文件夹，存放数据
├── files               文件夹，存放文件
├── src                 包，业务代码
│   └── __init__.py
└── utils               包，公共功能
    └── __init__.py