Python 入门:用 venv + pip 管好项目依赖,告别“在我电脑上能跑”

举报
yd_291742659 发表于 2026/11/15 06:07:39 2026/11/15
【摘要】 刚学 Python 的人,常会遇到一种尴尬:代码在自己的电脑上跑得好好的,换一台电脑或者发给同事,却报“找不到模块”;更糟的是,装了一个新库,旧项目反而跑不起来了。问题往往不在代码本身,而在依赖没有管好。venv 加 pip,就是 Python 自带的一套轻量解法,学会它,能省下很多排错时间。 一、为什么需要虚拟环境Python 的包是装在解释器环境里的。如果所有项目共用同一套全局环境,A ...

刚学 Python 的人,常会遇到一种尴尬:代码在自己的电脑上跑得好好的,换一台电脑或者发给同事,却报“找不到模块”;更糟的是,装了一个新库,旧项目反而跑不起来了。问题往往不在代码本身,而在依赖没有管好。venv 加 pip,就是 Python 自带的一套轻量解法,学会它,能省下很多排错时间。

一、为什么需要虚拟环境

Python 的包是装在解释器环境里的。如果所有项目共用同一套全局环境,A 项目要 requests 2.x,B 项目要 requests 1.x,就会互相打架;升级一个库,还可能顺带影响别的项目。虚拟环境(virtual environment)相当于给每个项目单独开一个“小房间”:解释器还是同一个,装的包却彼此隔离,互不干扰。

二、三步创建并激活 venv

在项目文件夹里执行:

python -m venv .venv

Windows 激活:

.venv\Scripts\activate

macOS / Linux 激活:

source .venv/bin/activate

激活后,命令行前面会出现 (.venv) 字样,说明你已经进入了这个项目的专属环境。退出时输入 deactivate 即可。注意:.venv 文件夹不用提交到代码仓库,记得把它写进 .gitignore。

三、用 pip 安装与固定依赖

在激活状态下安装库,只会装进当前虚拟环境:

pip install requests

项目要交付或换电脑时,靠一份依赖清单就能复原环境:

pip freeze > requirements.txt
pip install -r requirements.txt

第一条命令把当前环境装了哪些库、分别是哪个版本写进文件;第二条命令按清单一键装好。养成“装库就更新清单”的习惯,别人拿到你的项目,第一步就能跑起来。

四、新手最容易踩的四个坑

第一,忘记激活环境就装库,结果装到了全局环境,项目里还是找不到。第二,在不同项目间复用同一个虚拟环境,隔离就白做了。第三,只写库名不写版本,半年后重装,版本变了,代码可能不再兼容。第四,把 .venv 一起打包发给别人,体积大还容易出错——发 requirements.txt 就够了。

五、一个可以照抄的开工流程

新建项目时,按这个顺序走一遍:创建文件夹、建虚拟环境、激活、装依赖、生成 requirements.txt、写好 .gitignore。全程不过几分钟,却能让项目从第一天起就干净、可复现。等项目多起来,你会发现真正省时间的不是写代码的速度,而是少踩环境坑。

依赖管理不是什么高深技术,它更像一种工作习惯:每个项目有自己的环境,每份代码都有明确的依赖清单。把 venv 和 pip 用顺手,“在我电脑上能跑”这句话,就很少再出现了。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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