如何解决Python项目中不同版本的库冲突问题_使用虚拟环境venv进行隔离

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《如何解决Python项目中不同版本的库冲突问题_使用虚拟环境venv进行隔离》，聊聊，我们一起来看看吧！

必须先创建 .venv 是因为全局 pip install 会导致所有项目共享 site-packages，引发版本冲突；而 python -m venv .venv 可生成完全隔离的 Python 环境，确保依赖互不干扰。

直接用 venv 创建独立环境是最简单、最可靠的方式——它不依赖第三方工具，Python 3.3+ 自带，且能彻底切断项目间包版本干扰。

为什么必须先创建 .venv 而不是直接 pip install

全局 pip install 会把包装进系统 Python 的 site-packages，所有项目共享一套包。一旦两个项目分别需要 requests==2.25.0 和 requests==2.31.0，必然有一个报错。

• 运行 python -m venv .venv 会在当前目录生成一个完整隔离的 Python 副本，含独立解释器和 site-packages
• 激活后，which python（macOS/Linux）或 where python（Windows）必须指向 .venv/bin/python 或 .venv\Scripts\python.exe，否则没生效
• pip list 激活后应只显示 pip、setuptools 等基础包，空环境才是干净起点

激活后仍装到全局？检查这三件事

常见“以为激活了，其实没生效”的情况，本质是 shell 没真正切换解释器上下文。

• Windows 用户：用 .\.venv\Scripts\activate.bat（CMD）或 .\.venv\Scripts\Activate.ps1（PowerShell），后者需先执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
• macOS/Linux 用户：确认用了 source .venv/bin/activate，而不是双击或另开终端窗口
• IDE（如 VS Code）：即使终端激活了，编辑器右下角 Python 解释器路径仍可能显示系统路径，必须手动选中 .venv/bin/python

requirements.txt 不是摆设，得按它重装

只靠 venv 隔离还不够——如果多人协作时各自 pip install requests，有人装 2.28，有人装 2.31，行为就不可复现。

• 生成锁定文件：pip freeze > requirements.txt（仅适用于小项目）
• 更推荐：pip install pip-tools && pip-compile requirements.in，让 requirements.in 只写 requests、django 等顶层依赖，pip-compile 自动生成带精确版本和哈希的 requirements.txt
• 部署或换机器时，只执行 pip install -r requirements.txt，禁止 pip install 后再 pip freeze 覆盖原文件

最容易被忽略的是：.venv 目录绝不能提交到 Git，但 requirements.txt（或 poetry.lock）必须提交。环境可丢，锁文件不能丢——它才是你项目依赖事实的唯一权威来源。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。