vscode无原生“一键运行”功能,f5默认调试需配置launch.json;真正一键执行须绕过调试器,推荐ctrl+f5或右键“run python file in terminal”,前提为通过ctrl+shift+p选择确切解释器路径,且工作目录与脚本一致。

VSCode 本身没有“一键运行”这个功能,按 F5 默认走调试流程,不配 launch.json 就会报错;真正能直接执行脚本的,只有明确绕过调试器的几种方式。
Ctrl+F5 是最稳的一键运行方式
它本质是调用官方 Python 扩展的 Python: Run Python File in Terminal 命令,不启动调试器、不读断点、不加载 launch.json,等价于你在终端里敲 python script.py。
- 必须先通过
Ctrl+Shift+P→Python: Select Interpreter指定解释器路径,否则报"command 'python' not found" - 状态栏左下角显示的解释器路径要是真实可执行文件(如
C:Python312python.exe或/usr/local/bin/python3),不是模糊的Python 3.x (Global) - 工作目录默认为当前文件所在目录,若脚本依赖相对路径(比如
open("data.csv")),确保你是在该文件上按Ctrl+F5,而不是在资源管理器里选中其他目录后运行 - 输出中文乱码?Windows 上终端默认 GBK,可在设置里搜
terminal.integrated.defaultProfile.windows,设为 PowerShell,并在 PowerShell 配置文件里加$OutputEncoding = [System.Text.Encoding]::UTF8
右键菜单“Run Python File in Terminal”更透明
和 Ctrl+F5 行为一致,但错误信息直接暴露在终端里,适合快速定位问题,比如 ModuleNotFoundError 一眼就能看出缺哪个包。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构,支持CLI、API、爬虫、Bot、Django等多种项目类型,包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 不要依赖右上角绿色三角 ▶️ 按钮——它行为不稳定,受文件名含空格、扩展未激活、终端类型切换影响大
- 如果右键菜单没出现,说明 Python 扩展没装或没启用,检查左侧扩展面板是否已安装
ms-python.python - 执行后终端没自动滚到底部?按
Ctrl+Shift+P→ 输入Terminal: Scroll to Bottom手动触发,尤其对带time.sleep()或大量日志的脚本很关键
Code Runner 扩展要小心配置才安全
它默认调用系统 python 命令,不认你选的解释器,也不激活虚拟环境,所以用 pip 安装的包大概率导入失败。
- 安装后必须进设置搜
code-runner.runInTerminal,设为true;再搜code-runner.preserveFocus,设为false,否则终端弹出来但焦点不在,敲回车没反应 - 想让它用你选的解释器?改
code-runner.executorMap中的python条目,例如:"python": "python3 -u $fullFileName"(macOS/Linux)或"python": "C:\Python312\python.exe -u $fullFileName"(Windows) - 若脚本用
from .utils import helper这类相对导入,Code Runner 无法支持python -m模式,必须换用tasks.json自定义任务
真正容易被忽略的是解释器路径的确定性——VSCode 不读系统 PATH,也不继承 shell 环境变量,哪怕你在终端里能跑 python --version,它也可能完全找不到。每次新建项目、切换虚拟环境,都得手动重选一次解释器,这不是操作冗余,而是机制使然。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










