本文最后更新于 208 天前,其中的信息可能已经有所发展或是发生改变。
导言
Python环境管理的重要性
- 项目隔离与依赖控制
- 避免版本冲突:不同项目可能依赖同一库的不同版本,环境隔离确保每个项目使用正确版本的依赖,防止全局安装导致的冲突。
- 独立配置:允许项目单独使用特定 Python 解释器版本(如 Python 3.8 与 3.11 并存)。
- 可复现性
- 精确依赖记录:通过
requirements.txt或Pipfile确定每个依赖的版本,确保团队协作、测试和生产部署时环境一致。 - 一键重建:可通过依赖文件快速搭建相同环境,减少“在我这能跑,你那里咋回事”问题。
- 精确依赖记录:通过
- 系统安全与稳定性
- 避免污染系统环境:全局安装包可能会覆盖操作系统的工具(如 Linux 系统工具依赖 Python 包)。
- 安全权限:无需
sudo安装包,降低安全风险。
- 多项目并行开发
- 同时处理多个项目时(如 Django 4 和 Flask 项目),环境隔离允许无缝切换工具链。
- 简化调试与测试
- 在纯净环境中复现问题,排除无关依赖干扰。
- 轻松测试库在不同 Python 版本或依赖组合下的兼容性。
一、基础环境准备
软件
插件
- 1. Python扩展(Microsoft官方)
在 VSCode 的应用商店(快捷键:Ctrl + Shift + X)里搜索 Python 插件,并安装。如下图:

- 2. BasedPyright(语法补齐)
BasedPyright插件是Pyright的一个分支,具有各种类型检查改进、Pylance 功能等。
在 VSCode 的应用商店里搜索 BasedPyright 插件,并安装。如下图:

二、配置Python解释器
- 快捷键
Ctrl+Shift+P→ 输入Python: Select Interpreter→ 点击或Enter

- 识别并选择系统已安装的Python路径

三、虚拟环境配置
创建虚拟环境
- 快捷键
Ctrl+Shift+P→ 输入Python: Create Environment→ 点击或Enter

- 根据需求选择 Venv 或 Conda(科学计算推荐),这里以Venv为例

- 选择Python解释器版本

- 等待环境创建完毕

- 完成后VSCode会自动选择解释器为虚拟环境,如果没有可以 快捷键
Ctrl+Shift+P→ 输入Python: Select Interpreter→ 选择环境 - 或点击下方的菜单栏 → 选择环境

激活虚拟环境
- Windows:
.venv\Scripts\activate - macOS/Linux:
source .venv/bin/activate
如果遇到“无法加载文件,因为在此系统上禁止运行脚本。”的问题,参阅这篇文章
激活成功后会在终端提示符前显示 (.venv) 标识,如下:
(.venv) PS E:\path\to\project>
然后就可以正常在虚拟环境里运行项目了
The End.