如何优雅的搭建 Python 项目

当你熟悉了 Python 之后，就不会再满足只写一个脚本就完事，这个时候就需要考虑项目结构的事情了，尤其与别人合作完成一个项目的时候，项目的结构尤其重要。

本文分享如何优雅的开启一个 Python 项目。

简单来讲，分为 5 个步骤：

1、创建虚拟环境

你可以在项目目录中执行下面的命令，然后就会生成一个 venv 目录，这就是 Python 的虚拟环境，后面记得把 venv 添加到 .gitignore 文件中，避免被 Git 管理，从而避免上传到 GitHub。

python3 -m venv venv #创建
source venv/bin/activate #激活
deactivate #取消激活

在后面的编码过程中，我们会 pip install 一些依赖，项目依赖全部安装完成后，记得执行 pip freeze> requirements.txt 来保存项目的依赖，以便后续迁移或者部署的时候，可以很快安装依赖。

2、建立单独的单元测试目录

通常，在项目目录下建立 tests 文件夹，来存放单元测试文件，假如有一个 Python 文件名是 greetings.py 那单元测试的文件名就是 test_greetings.py，通常大家都用 pytest 来进行单元测试，可以查询 pytest 文件命名规范。

3、创建不同的内容目录

这个是灵活的，按个人风格来，总体上来说，以英文命名，体现架构层次，可以参照 Django 里面的 models,views,utils,app 等。

在一个目录中放入 __init__.py，表示这个目录是一个包，是用来导入使用的。

4、设计文档字符串及类型提示

文档字符串及类型提示，都是为了方便他人或自己来阅读和调用代码。

5、使用 Git、GitHub 进行版本管理

如果与其他人一起工作，Git GitHub 对于进行版本管理、代码审查、避免合并冲突是必不可少的。即使是自己独立编码，Git 和 GitHub 也是必备的版本控制工具。

最后

上面一些步骤在 Python 老司机看来比较繁琐，那么你可以使用 poetry 这个脚手架工具，自动为你创建好目录结构，管理虚拟环境、依赖、构建、运行等快捷服务。如果觉得有帮助，还请点个在看支持一下，感谢老铁。