pip 虚拟环境使用教程
一、什么是虚拟环境?
简单来说,虚拟环境就像一个独立的“小房间” 。
你在电脑上写Python程序时,可能需要用到各种第三方的库(比如requests、flask、django等)。问题来了:
- 项目A需要
requests的 1.0 版本 - 项目B需要
requests的 2.0 版本
如果你直接安装在电脑系统里,只能装一个版本,另一个项目就没法用了。
虚拟环境就是解决这个问题的——它为每个项目创建一个独立的“小房间”,每个房间里都有自己的Python解释器和一套独立的库,互不干扰。
打个比方:虚拟环境就像每个项目都有自己的“工具箱” ,而不是所有人共用一个大工具箱。这样你给项目A装工具,完全不会影响项目B。
二、为什么需要用虚拟环境?
- 依赖隔离:不同项目可以用不同版本的库,不会打架
- 干净整洁:系统Python保持干净,不会越用越乱
- 方便分享:可以通过
requirements.txt文件把项目需要的库清单分享给别人 - 便于部署:在服务器上可以一键安装所有依赖
三、准备工作:检查Python是否安装
打开终端(Windows上是“命令提示符”或“PowerShell”,Mac/Linux上是“终端”),输入以下命令:
python --version
或者
python3 --version
如果显示类似 Python 3.x.x 的结果,说明Python已安装。虚拟环境需要Python 3.3及以上版本(Python 3.3+ 内置了venv模块)。
如果提示找不到命令,请先去 python.org 下载安装Python。
四、一步一步:创建和使用虚拟环境
第1步:创建项目文件夹
首先,在电脑上创建一个存放项目的文件夹(你可以用任何名字):
创建文件夹
mkdir my_project
进入文件夹
cd my_project
第2步:创建虚拟环境
在项目文件夹里运行以下命令:
python -m venv .venv
这条命令会在当前目录创建一个叫 .venv 的文件夹,里面就是你的虚拟环境。
💡 小提示:
.venv是虚拟环境文件夹的常用名字(前面的点让它在文件夹列表里隐藏,不会碍眼)。你也可以起别的名字,比如myenv、venv都行。
创建成功后,你的项目文件夹里会多出一个 .venv 文件夹,里面包含:
- Python解释器的副本
- 独立的
pip工具 - 一个干净的第三方库存放位置
第3步:激活虚拟环境
这是最关键的一步! 只有激活了虚拟环境,你安装的包才会装到“小房间”里,而不是装到系统里。
不同操作系统命令不同:
| 操作系统 | 激活命令 |
|---|---|
| Windows (CMD) | .venv\Scripts\activate.bat |
| Windows (PowerShell) | .\.venv\Scripts\Activate.ps1 |
| macOS / Linux | source .venv/bin/activate |
如何确认激活成功了?
看命令行提示符——前面会出现 (.venv) 字样:
Windows
(.venv) C:\my_project>
或 Linux
(.venv) $
看到这个 (.venv) 前缀,就说明你已经在虚拟环境里了!
第4步:在虚拟环境中安装包
激活之后,用 pip install 安装包,它会自动装到当前的虚拟环境里:
pip install requests # 安装最新版
pip install requests==2.28.1 # 安装指定版本
pip install flask django # 一次安装多个
第5步:导出依赖清单(非常重要!)
当你安装了一些包之后,可以用这个命令把当前环境里所有包的名称和版本号导出到一个文件里:
pip freeze > requirements.txt
这个 requirements.txt 文件就像一份“购物清单”,记录了你的项目需要哪些包以及它们的版本。
别人拿到你的项目后,只需要运行下面这条命令,就能一键安装所有依赖:
pip install -r requirements.txt
第6步:退出虚拟环境
工作完成后,输入以下命令退出虚拟环境:
deactivate
命令行前的 (.venv) 前缀会消失,说明已经回到系统环境了。
五、完整流程速查表
把上面的步骤串起来,日常工作流程就是:
# 1. 创建项目并进入
mkdir my_project && cd my_project
# 2. 创建虚拟环境
python -m venv .venv
# 3. 激活虚拟环境(Windows)
.venv\Scripts\activate.bat
# 或(Mac/Linux)
source .venv/bin/activate
# 4. 安装需要的包
pip install flask requests
# 5. 导出依赖清单
pip freeze > requirements.txt
# 6. 工作结束,退出
deactivate
下次再回来工作时,只需要:
cd my_project
source .venv/bin/activate # 重新激活
# 然后继续写代码、装包...
六、其他常用命令
| 用途 | 命令 |
|---|---|
| 查看已安装的包 | pip list |
| 卸载某个包 | pip uninstall 包名 |
| 查看某个包的信息 | pip show 包名 |
| 删除整个虚拟环境 | 直接删除 .venv 文件夹 |
七、新手常见问题
Q1:Linux上提示找不到 venv 模块怎么办?
在 Ubuntu/Debian 系统上,需要单独安装:
sudo apt install python3-venv
Q2:Windows上激活失败怎么办?
如果 PowerShell 提示“无法加载脚本”,可以用管理员身份运行 PowerShell,然后执行:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
然后再试一次激活命令。或者直接用 CMD(命令提示符)来激活。
Q3:虚拟环境文件夹应该放在哪里?
放在项目文件夹里,和你的代码在一起。这样每个项目都有自己的虚拟环境,清晰明了。
Q4:虚拟环境文件夹要不要提交到 Git?
不要! 虚拟环境文件夹很大,而且不同电脑环境不同。应该在 .gitignore 文件里把 .venv/ 加进去。别人拿到你的代码后,自己创建虚拟环境,然后用 requirements.txt 安装依赖就行。
Q5:怎么确认我当前在不在虚拟环境里?
看命令行提示符有没有 (.venv) 前缀,或者运行:
which python # Mac/Linux
where python # Windows
如果在虚拟环境里,显示的路径会包含 .venv 文件夹。
八、小结
虚拟环境是Python开发的必备技能,其实并不复杂:
- 创建:
python -m venv .venv - 激活:
source .venv/bin/activate(Mac/Linux)或.venv\Scripts\activate(Windows) - 装包:
pip install 包名 - 导出:
pip freeze > requirements.txt - 退出:
deactivate
养成好习惯:每个Python项目都使用独立的虚拟环境,这样可以避免很多依赖冲突的麻烦
版权所有 © 【代码谷 - DMG】 欢迎非商用转载,转载请按下面格式注明出处,商业转载请联系授权,违者必究。(提示:点击下方内容复制出处)
源文: pip 虚拟环境使用教程 ,链接:https://www.daimagu.com/article/260824154731735.html,来源:代码谷 - DMG
评论