推荐使用标准项目结构并结合虚拟环境管理Python工程。1. 手动创建包含main.py、utils包、config.py和requirements.txt的目录结构;2. 用python3 -m venv venv创建虚拟环境并激活,实现依赖隔离;3. 通过pip freeze > requirements.txt导出依赖,便于环境复现;4. 使用PyCharm等IDE可自动创建项目及虚拟环境,适合初学者;5. 可选cookiecutter等模板工具生成专业项目结构。核心是保持代码结构清晰、依赖明确,基础方式适用于多数场景。

在 Python3 中新建一个工程并不需要复杂的工具,但为了便于管理代码、依赖和结构,推荐使用标准的项目组织方式。下面介绍几种常见的创建 Python 工程的方法。
1. 手动创建基本工程结构
你可以手动创建一个规范的 Python 工程目录,例如:
my_project/├── main.py
├── utils/
│ └── __init__.py
├── config.py
└── requirements.txt
说明:
- my_project/ 是项目根目录,名字可自定义。
- main.py 是程序入口文件。
- utils/ 是你写的模块目录,加 __init__.py 表示它是一个 Python 包。
- requirements.txt 用于记录项目依赖包。
2. 使用虚拟环境隔离依赖
建议每个项目使用独立的虚拟环境,避免包冲突。
立即学习“Python免费学习笔记(深入)”;
创建虚拟环境:
python3 -m venv venv激活虚拟环境:
- Linux/macOS: source venv/bin/activate
- Windows: venv\Scripts\activate
激活后,使用 pip 安装的包只会保存在这个项目中。
3. 初始化 requirements.txt
开发过程中,用以下命令导出依赖:
pip freeze > requirements.txt其他人可以通过以下命令安装相同环境:
pip install -r requirements.txt4. 使用 IDE 快速创建(如 PyCharm)
如果你使用 PyCharm:
- 选择 "New Project"
- 选择 Python 解释器(建议勾选 "Create virtual environment")
- 点击创建,IDE 会自动生成目录结构和虚拟环境
这种方式适合初学者或团队开发,自动化程度高。
5. 可选:使用项目模板工具(如 cookiecutter)
想快速生成专业结构?可以使用 cookiecutter:
pip install cookiecuttercookiecutter https://github.com/audreyfeldroy/cookiecutter-pypackage
它会引导你填写项目信息,自动生成完整发布级结构。
基本上就这些。对于大多数情况,手动创建 + 虚拟环境已经足够。随着项目变大,再考虑引入更高级的工具。关键是保持结构清晰、依赖明确。











