Python 入门:用 venv + pip 管好项目依赖,告别“在我电脑上能跑”
刚学 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 用顺手,“在我电脑上能跑”这句话,就很少再出现了。
- 点赞
- 收藏
- 关注作者
评论(0)