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

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

ztj100 2025-04-07 21:27 20 浏览 0 评论

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

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

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

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

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

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

目录结构图


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

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

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

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

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

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

  • main.py--主程序入口

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

Bash
# 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--程序发布包列表
Bash
# 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内的包,如下图:


安装 product.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 文件:安装、部署、打包的脚本。项目应写好脚本自动打包

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

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

相关推荐

前端案例·程序员的浪漫:流星雨背景

如果文章对你有收获,还请不要吝啬【点赞收藏评论】三连哦,你的鼓励将是我成长助力之一!谢谢!(1)方式1:简单版本【1】先看实现效果...

UI样式iPod classic的HTML本地音乐播放器框架

PS:音量可以鼠标点击按住在音量图标边的轮盘上下拖拽滑动音量大小中心按钮可以更改播放器为白色...

JavaScript 强制回流问题及优化方案

JavaScript代码在运行过程中可能会强制触发浏览器的回流(Reflow)...

Ai 编辑器 Cursor 零基础教程:推箱子小游戏实战演练

最近Ai火的同时,Ai编辑器Cursor同样火了一把。今天我们就白漂一下Cursor,使用免费版本搞一个零基础教程...

19年前司机被沉尸水库!凶手落网,竟已是身家千万的大老板

]|\[sS])*"|'(?:[^\']|\[sS])*'|[^)}]+)s*)/g,l=window.testenv_reshost||window.__moon_host||"res.wx.qq...

全民健身网络热度调查“居家健身”成为第一网络热词

]|\[sS])*"|'(?:[^\']|\[sS])*'|[^)}]+)s*)/g,l=window.testenv_reshost||window.__moon_host||"res.wx.qq...

取代JavaScript库的10个现代Web API及详细实施代码

为什么浏览器内置的API你还在用某个臃肿的Javascript库呢?用内置的API有什么好处呢?Web平台经历了巨大演进,引入了强大的原生API,不再需要臃肿的JavaScript库。现代浏览器现已支...

前端文件下载的N种姿势:从简单到高级

文件下载是web开发里一个非常常见的功能,无论是下载用户生成的数据、图片、文档还是应用程序包。前端开发者有多种方式来实现这一需求,每种方式都有其适用场景和优缺点。介绍下几种比较常用的文件下载方法。...

JavaScript 性能优化方法(js前端性能优化)

JavaScript性能优化方法减少DOM操作频繁的DOM操作会导致浏览器重绘和回流,影响性能。使用文档片段(DocumentFragment)或虚拟DOM技术减少直接操作。...

DOM节点的创建、插入、删除、查找、替换

在前端开发中,js与html联系最紧密的莫过于对DOM的操作了,本文为大家分享一些DOM节点的基本操作。一、创建DOM节点使用的命令是varoDiv=document.createElement...

前端里的拖拖拽拽(拖拽式前端框架)

最近在项目中使用了react-dnd,一个基于HTML5的拖拽库,“拖拽能力”丰富了前端的交互方式,基于拖拽能力,会扩展各种各样的拖拽反馈效果,因此有必要学习了解,最好的学习方式就是实操!...

大模型实战:Flask+H5三件套实现大模型基础聊天界面

本文使用Flask和H5三件套(HTML+JS+CSS)实现大模型聊天应用的基本方式话不多说,先贴上实现效果:流式输出:思考输出:聊天界面模型设置:模型设置会话切换:前言大模型的聊天应用从功能...

SSE前端(sse前端数据)

<!DOCTYPEhtml><htmllang="zh-CN"><head>...

课堂点名总尴尬?试试 DeepSeek,或能实现点名自由!(附教程)

2025年2月26日"你有没有经历过这样的场景?老师拿着花名册扫视全班:'今天我们来点名...'那一刻心跳加速,默念:'别点我!'但现在,我要...

我会在每个项目中复制这10个JS代码片段

你是否也有这种感觉:在搭建新项目时,你会想:"这个函数我是不是已经写过了...在某个地方?"是的——我也是。所以在开发了数十个React、Node和全栈应用后,我不再重复造轮子。我创建...

取消回复欢迎 发表评论: