必须手动指定python解释器绝对路径,vs code才可正常运行代码、提供语法提示、调试断点及正确import库;需先安装带path的python(官网下载并勾选“add python to path”),再安装vs code官方版,装microsoft官方python插件后重启,通过ctrl+shift+p选择完整路径解释器,右下角显示路径即生效,项目须以文件夹形式打开,推荐用python: create environment创建并自动绑定虚拟环境。

要在VS Code里正常运行Python代码、获得语法提示、调试断点和正确import第三方库,必须让编辑器明确知道该用哪个Python解释器执行——VS Code不会自动继承系统终端的PATH或虚拟环境状态,不手动指定路径,所有功能都会失效。
先装好Python解释器(带PATH)
打开python.org/downloads,下载Windows版Python 3.11或更新版本(如3.12、3.13)。安装时【务必勾选“Add Python to PATH”】,否则后续在VS Code终端里敲python命令会报“不是内部或外部命令”。
安装完成后,打开Windows终端(Win+R → 输入cmd → 回车),输入python --version。如果显示版本号(如Python 3.13.7),说明PATH生效;若提示错误,请重新运行Python安装包→选择Modify→再勾选Add Python to PATH。
装VS Code并配置基础环境
访问code.visualstudio.com下载官方安装包,不要从软件管家或应用商店获取——第三方渠道常捆绑弹窗插件。
安装过程中,在“选择附加任务”页【全部勾选】:Add to PATH、Create desktop icon、Register Code as editor、Add “Open with Code” to context menu。这四步确保你能从任意位置用code命令打开项目,右键文件夹直接用VS Code打开,且py文件默认用它打开。
安装完重启电脑,让PATH彻底生效。之后双击桌面图标启动VS Code。
装Python插件并绑定解释器
左侧点击扩展图标(四个方块),搜索“Python”,安装微软官方插件(作者Microsoft)。装完后关闭并重启VS Code——插件需重启才完全加载。
按下Ctrl+Shift+P调出命令面板,输入Python: Select Interpreter回车。列表中会出现带完整路径的选项,例如:
C:\Users\YourName\AppData\Local\Programs\Python\Python313\python.exe
优先选这个,而不是仅标“Python 3.13”但无路径的条目。
如果列表为空,点击“Enter interpreter path…”,粘贴以下命令结果:
在Windows终端中执行where python,复制输出的第一行路径,粘贴进去回车确认。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本,属于3.14系列的第二个维护更新。该版本包含了18项修复,重点解决了多进程、数据类及正则表达式等模块的回归问题,并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式(移除GIL)正式获得官方支持,是Python发展的重要里程碑。
成功绑定后,VS Code窗口右下角会显示所选解释器路径。若仍显示“Select Python interpreter”,说明未生效,【必须关闭整个VS Code窗口(不是仅关标签页),再重新打开】。
验证环境是否真正可用
第一步:用File → Open Folder打开一个空文件夹作为项目根目录——不能只打开单个.py文件,否则虚拟环境、settings.json等配置无法作用于整个项目。
第二步:在资源管理器中右键→New File,命名为test.py,输入print("Hello VS Code")。
第三步:右键编辑器空白处→Run Python File in Terminal,或按Ctrl+F5。下方集成终端应立即输出Hello VS Code。
若报错ModuleNotFoundError: No module named 'requests',说明pip安装的包没被当前解释器识别——这是正常现象,表示你已成功指向独立解释器,下一步可单独为该项目创建venv。
为项目创建并启用虚拟环境(推荐)
方法一:用命令面板快速生成
1. 按Ctrl+Shift+P,输入Python: Create Environment回车。
2. 选择Virtual Environment → 勾选“pip” → 确认位置为当前工作区根目录(默认./venv)。
3. 创建完成后,VS Code会自动提示“Would you like to select it as the default interpreter?”,点Yes。
方法二:手动创建并手动绑定
1. 在集成终端中执行python -m venv .venv(注意点号开头,生成隐藏文件夹)。
2. 执行.\venv\Scripts\Activate.ps1(PowerShell)或.\venv\Scripts\activate.bat(CMD)激活环境(仅终端生效,VS Code本身不感知)。
3. 再次Ctrl+Shift+P → Python: Select Interpreter → 从列表中选择./venv/Scripts/python.exe(Windows)或./venv/bin/python(macOS/Linux)。
激活虚拟环境后,右下角解释器路径会变成./venv/...,此时pip install的包只对该项目生效,彻底避免全局污染。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










