VSCode运行Python需先确保系统Python已加入PATH并能被终端识别，再安装Microsoft官方Python扩展、手动指定解释器路径，最后通过Ctrl+F5、命令面板或终端手动执行三种可靠方式运行；调试前必须生成launch.json配置文件。
VSCode 本身不运行 Python，必须装扩展、选解释器、确认 PATH —— 少一步，“右上角 ▶️ 按钮”就不会出现，Ctrl+F5 也会静默失败。
确认系统 Python 已就绪且能被终端识别
这是所有后续操作的硬前提。VSCode 的 Python 扩展不会自己找 Python，它只认终端里能敲出 python --version 的那个可执行文件。
- 在 VSCode 集成终端（
Ctrl + `）或系统终端中运行python --version或python3 --version，必须返回类似Python 3.12.4的输出 - Windows 用户若报
'python' is not recognized，大概率是安装时没勾选Add Python to PATH；需手动把C:\Users\Name\AppData\Local\Programs\Python\Python312\这类路径加进系统环境变量 - macOS/Linux 用户若用
pyenv或asdf管理版本，确保当前 shell 中which python指向你期望的解释器，否则 VSCode 启动时可能加载不到
安装官方 Python 扩展并手动指定解释器路径
微软的 ms-python.python 扩展是唯一能提供完整支持的组件；它不自动猜路径，也不读 PYTHONPATH，一切依赖你显式选择。
- 打开扩展面板（
Ctrl + Shift + X），搜Python，安装发布者为Microsoft的那个 - 打开任意
.py文件后，点击左下角状态栏显示的解释器路径（如Python 3.12.4），或按Ctrl + Shift + P输入Python: Select Interpreter - 若列表为空或显示错误路径，选
Enter interpreter path，粘贴完整路径：/usr/local/bin/python3（macOS/Linux）或C:\Python312\python.exe（Windows） - 该路径会写入项目根目录下的
.vscode/settings.json中的python.defaultInterpreterPath字段，优先级高于全局设置
一键运行的三种可靠方式及常见失效原因
别依赖右键菜单里的 “Run Python File”，它受文件名（如含空格）、终端类型（PowerShell vs Command Prompt）、扩展状态影响极大；以下三种才是稳定路径。
立即学习“Python免费学习笔记（深入）”；
-
Ctrl + F5（Windows/Linux）或Cmd + F5（macOS）：前提是已打开.py文件且解释器已选定；本质是调用Python: Run Python File in Terminal命令 - 命令面板（
Ctrl + Shift + P）输入Python: Run Python File in Terminal并回车：最透明，错误信息直接暴露在终端，比如ModuleNotFoundError一眼可见 - 终端中手动运行
python your_script.py：适合调试 pip 安装问题，例如python -m pip install requests必须在集成终端中执行，不能用上面两种“一键”方式 - 失效常见原因：
python.defaultInterpreterPath指向了虚拟环境但未激活、解释器路径含中文、工作区设置了错误的python.defaultInterpreterPath覆盖了用户级设置
调试前必须生成 launch.json，否则 F5 直接报错
VSCode 不会默认为你建调试配置，按 F5 启动调试时，它尝试生成 .vscode/launch.json；如果被禁用提示或项目根目录无写入权限，就会卡在 No configuration 错误。
- 首次调试前，先按
F5，接受 VSCode 自动生成的launch.json（模板为Python File） - 若失败，手动创建
.vscode/launch.json，内容至少包含：{ "version": "0.2.0", "configurations": [ { "name": "Python File", "type": "python", "request": "launch", "module": "your_module", "console": "integratedTerminal", "justMyCode": true } ] } -
"justMyCode": true很关键：避免调试时跳进requests、numpy等第三方包源码，专注自己的逻辑 - 调试时传参？在
launch.json中加"args": ["--input", "data.csv"]，比改代码再保存更高效
最容易被忽略的是解释器路径的“作用域”——全局设置、用户设置、工作区设置三层会互相覆盖；当你在一个项目里能跑，在另一个里点不动 ▶️，八成是工作区 .vscode/settings.json 里写了错误的 python.defaultInterpreterPath，删掉它，让 VSCode 重新选一次。
