【Python进阶系列】第10篇：Python 项目的结构设计与目录规范 —— 从脚本到模块，从混乱到整洁

“当你从写一个.py 文件走向组织一个工程时，你已经踏上了真正的 Python 进阶之路。”

写在前面

相信不少人学 Python 是从写脚本开始的。比如：爬点数据、自动填表、做个批量改文件名的工具等等。

刚开始写脚本没什么问题，但随着需求增多，你可能会逐渐遇到这些痛点：

• 项目一大，主程序 main.py 几百行，越来越乱；
• 功能越来越多，helper 函数、工具类、配置参数全堆在一起；
• 想引入单元测试、命令行调用、批量运行脚本，却不知道怎么整；
• 最惨的是，几周后你自己都看不懂自己的代码了……

这时候你就到了“从写脚本到写项目”的临界点。项目结构设计，就是你能不能从一个用脚本“解决问题的人”，成长为能开发产品的“开发者”的分水岭。

本篇文章，我会从实战的角度，教你如何从混乱中走出，逐步建立起一套清晰可维护的 Python 项目结构。

第一阶段：写脚本阶段的混乱美学

我们很多人都是从“文件堆积式项目结构”开始的，比如这样：