用 Python venv 和 pip 管理项目依赖:从入门到可复现
【摘要】 写 Python 项目时,最常见的坑就是“在我电脑上能跑”。原因往往是依赖混装在系统环境里。本文介绍用 venv 和 pip 为每个项目建立独立环境,并让环境可以复现。1. 为什么需要虚拟环境系统自带的 Python 会被操作系统工具使用,随意 pip install 可能破坏它。虚拟环境为每个项目提供独立的包目录,互不干扰,删除时直接删文件夹即可。2. 创建和激活在 Ubuntu 上先确认...
写 Python 项目时,最常见的坑就是“在我电脑上能跑”。原因往往是依赖混装在系统环境里。本文介绍用 venv 和 pip 为每个项目建立独立环境,并让环境可以复现。
1. 为什么需要虚拟环境
系统自带的 Python 会被操作系统工具使用,随意 pip install 可能破坏它。虚拟环境为每个项目提供独立的包目录,互不干扰,删除时直接删文件夹即可。
2. 创建和激活
在 Ubuntu 上先确认装了 venv 模块:
激活后命令行前面会出现 (.venv),此时 python 和 pip 都指向项目内部。退出用 deactivate。
3. 安装和记录依赖
requirements.txt 记录了所有包及其精确版本。把它提交到 Git,同事或服务器上就能还原同样的环境:
4. 几个实用习惯
- 把 .venv 写进 .gitignore,不要提交环境本身。
- 直接依赖和间接依赖较多时,可以手写一个 requirements.in 只列直接依赖,再用 pip-tools 生成锁定文件。
- 用 pip list –outdated 查看过期包,升级前先在测试环境验证。
- 国内网络慢时,可临时指定镜像:pip install -r requirements.txt -i https://repo.huaweicloud.com/repository/pypi/simple,华为云镜像站可以用。
5. 在服务器和 Docker 中使用
部署时,可以在 systemd 服务里直接调用 .venv/bin/python 来启动程序,不需要 activate。在 Dockerfile 里则通常不用 venv,因为容器本身已经隔离,直接 pip install -r requirements.txt 即可。
6. 常见问题
- 提示 externally-managed-environment:说明你在往系统 Python 里装包,改用 venv 即可。
- 换了目录后环境失效:venv 里写死了绝对路径,移动项目后请重新创建。
- 版本冲突:删掉 .venv 重建,是最省心的排查方式。
小结
每个项目一个 venv,依赖写进 requirements.txt,这两步能避免大部分环境问题。新项目开始时养成习惯,后面部署和协作都会轻松很多。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)