用 Python venv 和 pip 管理项目依赖:从入门到可复现

举报
yd_291309839 发表于 2026/11/13 20:51:50 2026/11/13
【摘要】 写 Python 项目时,最常见的坑就是“在我电脑上能跑”。原因往往是依赖混装在系统环境里。本文介绍用 venv 和 pip 为每个项目建立独立环境,并让环境可以复现。1. 为什么需要虚拟环境系统自带的 Python 会被操作系统工具使用,随意 pip install 可能破坏它。虚拟环境为每个项目提供独立的包目录,互不干扰,删除时直接删文件夹即可。2. 创建和激活在 Ubuntu 上先确认...

写 Python 项目时,最常见的坑就是“在我电脑上能跑”。原因往往是依赖混装在系统环境里。本文介绍用 venv 和 pip 为每个项目建立独立环境,并让环境可以复现。

1. 为什么需要虚拟环境

系统自带的 Python 会被操作系统工具使用,随意 pip install 可能破坏它。虚拟环境为每个项目提供独立的包目录,互不干扰,删除时直接删文件夹即可。

2. 创建和激活

在 Ubuntu 上先确认装了 venv 模块:

sudo apt install -y python3-venv
cd ~/myproject
python3 -m venv .venv
source .venv/bin/activate

激活后命令行前面会出现 (.venv),此时 python 和 pip 都指向项目内部。退出用 deactivate。

3. 安装和记录依赖

pip install requests flask
pip freeze > requirements.txt

requirements.txt 记录了所有包及其精确版本。把它提交到 Git,同事或服务器上就能还原同样的环境:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

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. 常见问题

  1. 提示 externally-managed-environment:说明你在往系统 Python 里装包,改用 venv 即可。
  2. 换了目录后环境失效:venv 里写死了绝对路径,移动项目后请重新创建。
  3. 版本冲突:删掉 .venv 重建,是最省心的排查方式。

小结

每个项目一个 venv,依赖写进 requirements.txt,这两步能避免大部分环境问题。新项目开始时养成习惯,后面部署和协作都会轻松很多。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。