Python学习之Python开发规范

最新推荐文章于 2024-05-26 16:20:58 发布

栽树先生～

最新推荐文章于 2024-05-26 16:20:58 发布

阅读量393

点赞数

分类专栏： Python 文章标签： python 学习开发语言

本文链接：https://blog.csdn.net/qq_43143025/article/details/128426442

版权

Python 专栏收录该内容

7 篇文章 0 订阅

订阅专栏

本文介绍了在开发Python程序时如何遵循良好的结构规范，包括单文件程序的注释、导入和函数定义，以及多文件项目的组织结构，如独立的主文件、配置文件、数据和功能代码的存放。强调了代码的可读性和维护性，推荐了项目文件夹结构以提高专业性。

摘要由CSDN通过智能技术生成

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

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