VSCode中Python无法运行需依次完成五步:一、安装含PATH的Python解释器并验证版本;二、安装Microsoft官方Python扩展并重启;三、通过命令面板选择已安装解释器路径;四、新建保存.py文件后用右键或绿色按钮运行;五、用Ctrl+`打开集成终端,cd至项目目录后执行python/python3命令。

如果您在 VSCode 中编写 Python 代码却无法运行,通常是因为 Python 解释器未正确配置或缺少必要扩展。以下是完成 Python 环境配置与代码运行的完整操作流程:
一、安装 Python 解释器
VSCode 本身不包含 Python 运行环境,必须先在系统中安装官方 Python 解释器,否则所有 Python 功能均无法启用。安装后需确保其路径被系统识别。
1、访问 https://www.python.org/downloads/,下载与操作系统匹配的最新稳定版安装包。
2、运行安装程序,在安装界面勾选 Add Python to PATH 选项,再点击“Install Now”。
立即学习“Python免费学习笔记(深入)”;
3、安装完成后,在终端(Windows:cmd 或 PowerShell;macOS/Linux:Terminal)中输入 python --version 或 python3 --version,确认输出类似 Python 3.12.4 的版本信息。
二、安装 Python 扩展
VSCode 需通过官方 Python 扩展提供语法高亮、智能提示、调试支持等核心功能。该扩展由 Microsoft 维护,是 Python 开发的必备组件。
1、打开 VSCode,点击左侧活动栏的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入 Python,找到发布者为 Microsoft 的扩展。
3、点击“Install”按钮安装,安装完成后点击“Reload”重启 VSCode 以激活扩展功能。
三、配置 Python 解释器路径
安装扩展后,VSCode 需明确指定使用哪一个 Python 可执行文件作为解释器,否则将无法运行代码或显示错误提示。
1、打开一个 .py 文件,或新建一个空文件并保存为 test.py。
2、按下 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),调出命令面板。
3、输入 Python: Select Interpreter,回车确认。
4、在弹出列表中选择已安装的 Python 版本(如 Python 3.12.4 ('System') - /usr/bin/python3 或 Python 3.12.4 (venv)),若未出现,请点击 Enter interpreter path... 手动定位 python.exe 或 python3 可执行文件。
四、创建并运行第一个 Python 文件
完成解释器配置后,即可直接在 VSCode 内编辑、保存并运行 Python 脚本,无需切换外部终端。
1、新建一个文件,输入以下内容:print("Hello, VSCode Python!")。
2、按 Ctrl+S(Windows/Linux)或 Cmd+S(macOS)保存,文件名设为 hello.py,保存时确保文件类型为 Python(右下角状态栏应显示 Python)。
3、右键编辑器空白区域,选择 Run Python File in Terminal;或点击右上角绿色三角形按钮;或使用快捷键 Ctrl+F5(Windows/Linux)/Cmd+F5(macOS)。
五、使用集成终端手动执行
VSCode 内置终端可替代系统终端,便于快速测试命令和查看输出,尤其适合调试多步骤脚本或虚拟环境操作。
1、按下 Ctrl+`(反引号键)打开集成终端。
2、确认终端当前路径为含 .py 文件的目录,若不是,使用 cd 命令切换,例如:cd /path/to/your/project。
3、输入运行命令:python hello.py(Windows)或 python3 hello.py(macOS/Linux),回车后查看输出结果。










