【VS Code 中 Python 虚拟环境降级完整指南（含 uv 工具实战）】

前言在使用 Python 进行项目开发时我们经常会遇到需要切换 Python 版本的情况。比如项目依赖某个特定的 Python 版本或者发现当前版本与某些库不兼容。今天我就遇到了这样一个场景原本在.venv虚拟环境中使用的是 Python 3.14但项目需要降级到 Python 3.12。整个过程踩了一些坑在此记录分享希望能帮助到遇到同样问题的开发者。问题背景我的项目目录结构如下C:\Users\15135\Desktop\xm-file\ocr\ ├── .venv\ # 虚拟环境 ├── ocr.py # Python 脚本 └── ... # 其他文件运行ocr.py时遇到ModuleNotFoundError: No module named numpy但安装 paddle-gpu 失败决定将 Python 版本从 3.14 降级到 3.12。核心知识点重要概念Python 虚拟环境一旦创建其中的 Python 版本就被固定了无法直接原地降级。唯一的解决方案是删除旧环境用目标 Python 版本重新创建。方案使用 uv 管理 Python 版本推荐1. 退出当前虚拟环境deactivate2. 查看 uv 已安装的 Python 版本uv python list输出示例cpython-3.14.3-windows-x86_64-none C:\Users\15135\AppData\Roaming\uv\python\... cpython-3.13.12-windows-x86_64-none download available cpython-3.12.13-windows-x86_64-none download available cpython-3.11.15-windows-x86_64-none download available ...3. 安装目标 Python 版本如 3.12uv python install 3.124. 删除旧的虚拟环境Remove-Item-Recurse-Force.venv5. 用指定版本重新创建虚拟环境uv venv--python 3.12.venv6. 激活新环境.venv\Scripts\activate7. 验证 Python 版本python--version# 应显示 Python 3.12.138. 重新安装项目依赖# 如果有 requirements.txtpip install-r requirements.txt# 或使用 uv 安装更快uv pip install-r requirements.txt# 或逐个安装pip install numpy# 根据运行报错继续安装其他依赖9. 在 VS Code 中切换解释器按CtrlShiftP打开命令面板输入Python: Select Interpreter选择项目目录下.venv中的 Python 解释器踩坑记录坑1python -0命令无效python-0# Unknown option: -0原因-0是py命令的选项不是python的。正确用法是py -0。坑2py命令未找到py-0# py : 无法将“py”项识别为 cmdlet...原因Python Launcher for Windows 未安装或未添加到 PATH。解决方案是安装 Python 时勾选 “py launcher” 选项或使用uv替代。坑3激活虚拟环境后仍显示旧版本.venv\Scripts\activate python--version# 还是显示 3.14原因没有删除旧的.venv目录就直接重建。解决删除旧环境再重建。完整操作流程实录以下是我实际操作的全过程每一步都有输出# 1. 查看可用 Python 版本PS uv python list cpython-3.14.3-windows-x86_64-none# 当前使用的版本cpython-3.12.13-windows-x86_64-none download available...# 2. 安装 Python 3.12PS uv python install 3.12 Installed Python 3.12.13 in 12.22scpython-3.12.13-windows-x86_64-none# 3. 删除旧虚拟环境PSRemove-Item-Recurse-Force.venv# 4. 创建新虚拟环境PS uv venv--python 3.12.venvUsingCPython 3.12.13 Creating virtual environment at:.venv Activate with:.venv\Scripts\activate# 5. 激活环境PS.venv\Scripts\activate# 6. 安装依赖(.venv)PS pip install numpy Successfully installed numpy-1.26.4# 7. 运行程序(.venv)PS python ocr.py# 程序正常运行常用命令速查表操作命令退出虚拟环境deactivate查看 uv 管理的 Python 版本uv python list安装指定 Python 版本uv python install 3.12删除虚拟环境Remove-Item -Recurse -Force .venv创建指定版本的虚拟环境uv venv --python 3.12 .venv激活虚拟环境.venv\Scripts\activate查看 Python 版本python --version安装依赖pippip install -r requirements.txt安装依赖uvuv pip install -r requirements.txtVS Code 切换解释器CtrlShiftP→Python: Select Interpreter总结虚拟环境 Python 版本不可直接降级必须重建推荐使用 uv管理 Python 版本和虚拟环境速度快且易用删除旧环境再重建是最干净、最可靠的方式重建后记得重新安装项目依赖在 VS Code 中需要手动切换解释器到新的虚拟环境希望这篇文章能帮助到遇到类似问题的开发者。如果你有更好的方法或遇到其他问题欢迎在评论区交流讨论相关链接uv 官方文档Python 虚拟环境官方文档