百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

python 目录结构的规划,应该先建立好

itomcoil 2025-09-18 20:11 1 浏览

上一篇文章说了【 函数、类、模块、包】,现在说一下 python 一般工程的目录结构

一般习惯这样规划目录,在开始一个工程前,最好先把目录结构规划好。

一、为什么要有一个比较清晰的目录结构

此处省略一万字......

二、介绍一个比较清晰的目录结构

现在先看一张目录结构图吧

目录结构图


现在介绍一下这个目录结构,项目目录 project_app下,从上到下介绍

1、docs目录:存放一些文档或全局配置文件

  • config.ini--配置文件
  • 使用手册
  • 其他一些文档类内容

2、extas目录:程序的扩展。比如用C或C++写的东西,或Dll文件之类的

3、logs目录:日志文件放这里。(可以考虑单例模式写入日志文件哦,点击【单例模式】)

4、main包:主程序入口包。

  • main.py--主程序入口

说明:主程序入口,需要把顶级目录加入到解释器中去搜索模块,默认没有这个路径只是pycharm帮助加的

# main.py 模块
import os
import sys
# 主程序入口 把项目目录加入环境变量
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(BASE_DIR) # 程序启动,加入环境变量中,程序结束自动删除
print(BASE_DIR) # 返回:D:\project_app

5、myproject包:这里是主程序,编写业务逻辑

  • common--此包下可编写通用的模块,如工具模块,日志模块,邮件模块等等
  • tests--此包为主程序单元测试包

6、requirements目录:存放整个应用依赖的外部Python包列表。简单点就一个requirements.txt,我建议三个文件,通用包、开发包、发布包区分开,看项目需要吧。

  • common.txt--程序通用包列表
  • develop.txt--程序开发包列表
  • product.txt--程序发布包列表
# common.txt 内容
click==6.7
# develop.txt 内容
-r common.txt
coverage==4.4.1
# product.txt 内容
-r common.txt
requests==2.18.2

安装 develop.txt 文件中的依赖包

D:\project_app> venv_0\Scripts\activate.bat # 进入虚拟环境
(venv_0) D:\project_app> cd requirements
(venv_0) D:\project_app\requirements> pip install -r develop.txt

因有 -r common.txt ,所以在安装 develop.txt 时,会先安装 common.txt内的包,如下图:


7、res 目录(resource的简写):存放各种图片资源

8、venv_0 目录:python 虚拟环境目录,一个程序对应一个虚拟环境,保证了第三方模块版本的一致性。如何安装虚拟环境点击【虚拟环境安装

D:\>cd project_app # 进入项目目录
D:\project_app>python -m venv venv_0 # 创建虚拟环境
D:\project_app> venv_0\Scripts\activate.bat # 进入虚拟环境
D:\project_app> pip install flask # 安装flask框架
D:\project_app> venv_0\Scripts\deactivate.bat # 退出虚拟环境

9、README.txt 文件:项目说明文件。

  • 项目主要功能
  • 代码结构
  • 安装环境
  • 启动命令之类

10、setup.py 文件:安装、部署、打包的脚本。项目应写好脚本自动打包

好了,你做程序时,先建一个这样的目录,然后再开始写程序吧。

记得关注、点赞哦,后面越来越精彩。

相关推荐

ELK架构部署以及应用_elk部署方案

一、ELK介绍ELK代表的是Elasticsearch,Logstash,KibanaElasticsearch:日志存储、搜索分析功能Logstash:数据收集,日志收集系统Kibana:数据可视化...

本地部署 DeepSeek Janus Pro 文生图大模型

Hello,大家新年好。在这个春节期间最火的显然是DeepSeek了。据不负责统计朋友圈每天给我推送关于DeepSeek的文章超过20篇。打开知乎跟B站也全是DeepSeek相关的内容。...

DotsOCR 环境搭建指南_dot installation

DotsOCR环境搭建指南支持平台:Linux(推荐)或Windows+WSL2项目地址:https://github.com/rednote-hilab/dots.ocr一、Windo...

spark+python环境搭建_pycharm配置spark环境

最近项目需要用到spark大数据相关技术,周末有空spark环境搭起来...目标spark,python运行环境部署在linux服务器个人通过vscode开发通过远程python解释器执行代码准备...

window下sublimeIDE安装python_win10安装python

window下开发python使用sublimeIDE1安装sublimehttp://www.sublimetext.com/22安装PackageControl提供了安装sublime...

JupyterLab 快速环境配置 (一)_jupyter的环境配置

JupyterLab快速环境配置(一)一只小胖子[互联网运营|直播电商|广告行业]从业者软件说明:JupyterLab是一个基于web浏览器的在线文档/代码运行集成环境,支持文档显示/代...

栋察宇宙(二十一):Python 文件操作全解析

分享乐趣,传播快乐,增长见识,留下美好。亲爱的您,这里是LearingYard学苑!今天小编为大家带来“Python文件操作全解析”欢迎您的访问!Sharethefun,spreadthe...

外婆都能学会的Python教程(十八):Python读取配置文件绘制图形

前言Python是一个非常容易上手的编程语言,它的语法简单,而且功能强大,非常适合初学者学习,它的语法规则非常简单,只要按照规则写出代码,Python解释器就可以执行。下面是Python的入门教程介绍...

Python自动化办公应用学习笔记38—文件读写方法2

1.文件迭代文件对象是可迭代的,可以逐行迭代文件。withopen('data.txt','r')asfile:forlineinfile:#逐行迭...

简析python 文件操作_python文件内容操作

一、打开并读文件1、file=open('打开文件的路径','打开文件的权限')#打开文件并赋值给file#默认权限为r及读权限str=read(num)读文件并放到字符串变量中,其中num表...

如何在Python中保存文件?如何读取文件?示例代码

Python中保存文件是一项非常基本的任务,它允许我们将程序输出保存到磁盘上,以便以后使用或与他人共享。本文将介绍如何在Python中保存文件的方法,以及如何读取已有的文件和为代码添加注释。使用ope...

高效办公:Python处理excel文件,摆脱无效办公

一、Python处理excel文件1.两个头文件importxlrdimportxlwt其中xlrd模块实现对excel文件内容读取,xlwt模块实现对excel文件的写入。2.读取exce...

python中12个文件处理高效技巧,不允许你还不知道

在Python中高效处理文件是日常开发中的核心技能,尤其是处理大文件或需要高性能的场景。以下是经过实战验证的高效文件处理技巧,涵盖多种常见场景:一、基础高效操作1.始终使用上下文管理器(with语句)...

python 目录结构的规划,应该先建立好

上一篇文章说了【函数、类、模块、包】,现在说一下python一般工程的目录结构一般习惯这样规划目录,在开始一个工程前,最好先把目录结构规划好。一、为什么要有一个比较清晰的目录结构此处省略一万字....

和尧名大叔一起从0开始学Python编程-简单读写文件

0基础自学编程是很痛苦的一件事情,所以我想把自己学习的这个过程记录下来,让想学编程的人少走弯路,大叔文化程度较低,可能会犯一些错误,欢迎大家督促我。今天,我们来学习一下用Python简单读写文件,这里...