VSCode配置Python的核心是正确选择项目级虚拟环境解释器。安装Python(3.9+)、VSCode及官方Python扩展后,在项目根目录创建venv,通过命令面板选择对应python解释器,底部状态栏显示路径即生效;后续补全、调试、格式化、Linting等功能自动适配。

在 VSCode 中配置 Python,核心是让编辑器识别并正确使用你的 Python 解释器——尤其是项目级虚拟环境。只要这一步到位,补全、调试、格式化、Linting 等功能都会自动适配,不需要额外“开启”。
装好基础组件
确保三样东西已就位:
- 系统已安装 Python(推荐 3.9+),安装时勾选 Add Python to PATH
- 已安装 VSCode(从官网下载,非第三方渠道)
- 在 VSCode 扩展市场(Ctrl+Shift+X)中安装官方 Python 扩展(微软出品,图标为蓝色蛇形)
创建并选择虚拟环境
避免全局污染,每个项目建议用独立虚拟环境:
- 在项目根目录打开终端,运行:
Windows:python -m venv venv
macOS/Linux:python3 -m venv venv - 按 Ctrl+Shift+P,输入并选择 Python: Select Interpreter
- 从列表中选中
./venv/Scripts/python.exe(Windows)或./venv/bin/python(macOS/Linux) - 确认 VSCode 底部状态栏显示该路径,说明已切换成功
验证和常用增强
配置是否生效?写一行代码验证:
云模块_YunMOK网站管理系统采用PHP+MYSQL为编程语言,搭载自主研发的模块化引擎驱动技术,实现可视化拖拽无技术创建并管理网站!如你所想,无限可能,支持创建任何网站:企业、商城、O2O、门户、论坛、人才等一块儿搞定!永久免费授权,包括商业用途; 默认内置三套免费模板。PC网站+手机网站+适配微信+文章管理+产品管理+SEO优化+组件扩展+NEW Login界面.....目测已经遥遥领先..
立即学习“Python免费学习笔记(深入)”;
- 新建
test.py,输入:import sys; print(sys.executable) - 运行后输出路径应指向你
venv文件夹内,不是全局 Python 路径 - 如需自动格式化,安装
black:pip install black,再在设置中启用 Format on Save - 如需静态检查,安装
flake8:pip install flake8,VSCode 会自动识别并标出问题
运行与调试不用额外配置
解释器选对了,这些功能就直接可用:
- 点击编辑器右上角绿色 ▶️ 按钮,即可运行当前文件
- 按 F5 启动调试,VSCode 会自动生成
.vscode/launch.json(首次调试时) - 断点、变量监视、调用堆栈等调试能力全部就绪,无需手动改配置










