Python进阶教程:项目工程化与虚拟环境

📅 2026/8/24 13:43:52
Python进阶教程:项目工程化与虚拟环境
目录Python进阶教程项目工程化与虚拟环境一、虚拟环境二、依赖管理2.1 requirements.txt2.2 依赖分组生产/开发三、项目目录结构四、.gitignore 必备规则五、包管理进阶pip 与 pipenv六、使用第三方工具提升效率6.1 pyproject.toml 现代配置6.2 一键脚本七、实战搭建一个规范的项目项目初始化清单总结Python进阶教程项目工程化与虚拟环境本文是Python 入门教程系列的第 15 篇扩展篇。前面学习了语法和库本篇介绍如何把代码组织成规范、可维护、可分享的工程项目。一、虚拟环境不同项目依赖的库版本可能冲突虚拟环境让每个项目独立隔离依赖# 创建虚拟环境Python 3.3 内置python-mvenv myenv# 激活Windowsmyenv\Scripts\activate# 激活macOS / Linuxsourcemyenv/bin/activate# 退出deactivate二、依赖管理2.1 requirements.txt# 导出当前环境依赖pip freezerequirements.txt# 在新环境安装pipinstall-rrequirements.txt2.2 依赖分组生产/开发# requirements.txt生产依赖 flask3.0.0 requests2.31.0 # requirements-dev.txt开发依赖 -r requirements.txt pytest8.0.0 black24.1.0 flake87.0.0三、项目目录结构my_project/ ├── README.md # 项目说明 ├── requirements.txt # 依赖清单 ├── .gitignore # Git 忽略规则 ├── setup.py / pyproject.toml # 打包配置 ├── src/ │ └── my_package/ │ ├── __init__.py │ ├── main.py │ ├── utils.py │ └── models.py ├── tests/ # 测试目录 │ ├── __init__.py │ ├── test_utils.py │ └── test_models.py ├── docs/ # 文档 └── scripts/ # 辅助脚本四、.gitignore 必备规则# Python 缓存与构建 __pycache__/ *.py[cod] build/ dist/ *.egg-info/ # 虚拟环境 venv/ myenv/ .venv/ # 测试与覆盖率 .pytest_cache/ .coverage htmlcov/ # IDE 与系统 .vscode/ .idea/ .DS_Store # 敏感信息 .env *.env五、包管理进阶pip 与 pipenv# 查看已安装包pip list# 查看包信息pip show requests# 更新包pipinstall--upgraderequests# 卸载pip uninstall requests六、使用第三方工具提升效率6.1 pyproject.toml 现代配置[build-system] requires [setuptools61.0] build-backend setuptools.build_meta [project] name my-project version 0.1.0 description 一个示例项目 requires-python 3.9 dependencies [ flask3.0, requests2.31, ] [project.optional-dependencies] dev [pytest, black, flake8]6.2 一键脚本# scripts/setup.sh / setup.bat# 一键创建虚拟环境并安装依赖# Windows (setup.bat)python-m venv myenv call myenv\Scripts\activate.bat pip install-r requirements.txt echo 环境配置完成七、实战搭建一个规范的项目# 步骤 1创建目录结构 project_root/ ├── requirements.txt ├── .gitignore └── src/ └── hello_cli/ ├── __init__.py └── main.py # 步骤 2编写代码src/hello_cli/main.py def main(): print(Hello, Project!) if __name__ __main__: main() # 步骤 3初始化 Git 并提交 git init git add . git commit -m init project项目初始化清单创建虚拟环境编写 requirements.txt编写 .gitignore建立 src / tests / docs 目录初始化 Git 仓库编写 README.md首次提交代码总结本篇介绍了虚拟环境、依赖管理、项目目录结构、.gitignore 规范等工程化基础。良好的工程习惯能让项目更易维护、协作和部署。下一篇将介绍自动化办公用 Python 解放重复劳动。