当初学 Python 要是有人告诉我这六个项目结构规范，能少走半年弯路

学Python那会儿我踩了不少坑。代码写着写着就乱成一团，自己都懒得看。后来才明白，项目结构规范比语法重要得多。今天把这六个规范喂给你，能少走弯路。

第一，把项目根目录当客厅。别什么都往根目录堆。一个main.py就够了，其他脚本、数据、配置全部装进子文件夹。根目录干净了，找文件不用翻半天。我见过有人一个目录下塞了30个.py文件，光看名字就头晕。

第二，建一个src文件夹放核心代码。业务逻辑全塞进src里。测试代码放test文件夹，配置文件放config文件夹，数据文件放data文件夹。这样别人接手项目，瞄一眼文件夹就知道东西在哪。我早期把所有文件平铺，后来改结构花了三天。

第三，把功能拆成模块。别把所有函数写在一个文件里。按功能分文件。处理数据的叫data_handler.py，网络请求的叫api_client.py，工具函数叫utils.py。一个文件超过200行就该想想要不要拆。我见过5000行的单文件，滚动都要半天。

第四，用__init__.py让包像模块。在每个文件夹下放个空的__init__.py文件。这样就能用from src import data_handler这样的导入方式。没这个文件，导入时会报错。我当初不知道这个，硬是用相对路径绕来绕去，烦得要死。

第五，写requirements.txt记录依赖。项目用到了哪些第三方库，版本号多少。一行一个记录。别人拿到代码，直接pip install -r requirements.txt就能装好环境。我吃过亏，把代码发给别人，结果对方装了一堆版本冲突的库，跑不起来。

第六，用.gitignore排除不必要的文件。有些东西不该进版本控制。比如__pycache__文件夹，比如.ide文件，比如日志文件。不设这个，每次提交都会带上几百个没用的文件。我刚开始用git，把整个文件夹推上去，结果里面有个几百兆的数据文件，拉下来要老半天。

这六个规范看起来简单，但真能做到的人不多。我见过一个实习生写的项目，根目录就一个单文件加一堆csv，问他为什么不拆分，他说能跑就行。项目最后被他改成一团浆糊，谁都不敢碰。

结构规范不是为了好看。它让你写代码时思路更清晰。想改某个功能，不用翻遍整个项目。想加新功能，知道该把文件放哪。想找人帮忙，对方看一眼就能上手。

别等到代码写成屎山才想起来整理。现在就去看看你的项目目录，该拆的拆，该排的排。花半天时间整理结构，能省下后面半年改bug的功夫。

更多相关技术内容咨询欢迎前往并持续关注好学星城论坛了解详情。

想高效系统的学习Python编程语言，推荐大家关注一个微信公众号：Python编程学习圈。每天分享行业资讯、技术干货供大家阅读，关注即可免费领取整套Python入门到进阶的学习资料以及教程，感兴趣的小伙伴赶紧行动起来吧。

0 条评论