VSCode需手动配置Python解释器和安装官方扩展才能运行Python文件；必须先在系统安装Python并加入PATH，再安装ms-python.python扩展、选择正确解释器路径，最后用Ctrl+F5或命令面板运行文件。
VSCode 本身不自带 Python 运行能力，必须手动配置解释器和基础工具链；没选对 python.pythonPath 或没装 Python 扩展，Run Python File 按钮根本不会出现。
确认系统已安装 Python 并能被终端识别
这是所有后续操作的前提。VSCode 的 Python 扩展依赖系统 PATH 中的 python 或 python3 命令。
- 在终端（Windows PowerShell / macOS Terminal / Linux Shell）中运行
python --version或python3 --version，必须返回版本号（如3.12.1） - 如果报错
command not found或'python' is not recognized，先去 python.org 下载安装包，并勾选Add Python to PATH - Windows 用户尤其注意：安装时若跳过 PATH 选项，需手动把 Python 安装目录（如
C:\Users\Name\AppData\Local\Programs\Python\Python312\）加进系统环境变量
安装 Python 扩展并指定解释器路径
VSCode 的 Python 支持由微软官方 ms-python.python 扩展提供，它负责语法高亮、调试、代码补全等，但不会自动猜解你的 Python 安装位置。
- 在扩展市场搜索并安装
Python（发布者是Microsoft） - 打开一个
.py文件后，左下角状态栏会显示“Select Python Interpreter”或当前解释器路径；点击它，从列表中选择你刚确认可用的python或python3 - 如果列表为空或路径错误，选
Enter interpreter path...，手动输入完整路径（如/usr/local/bin/python3或C:\Python312\python.exe） - 该选择会写入工作区设置
.vscode/settings.json的python.defaultInterpreterPath字段，优先级高于全局设置
运行单个 Python 文件的三种可靠方式
别依赖右键菜单里可能消失的“Run Python File in Terminal”，它受扩展状态、文件名、终端类型影响较大；用以下任一方法更稳定：
立即学习“Python免费学习笔记（深入）”；
- 快捷键
Ctrl+F5（Windows/Linux）或Cmd+F5（macOS），前提是已打开.py文件且解释器已选定 - 命令面板（
Ctrl+Shift+P）输入Python: Run Python File in Terminal，回车执行 - 终端中手动运行：
python your_script.py—— 这种方式最透明，能第一时间看到 ImportError 或编码错误
注意：python -m pip install 类命令必须在集成终端里运行，不能用上面的“Run Python File”功能。
调试配置容易漏掉 launch.json
按 F5 启动调试前，VSCode 默认会尝试生成 .vscode/launch.json；但如果项目根目录没有该文件，且你禁用了自动提示，调试就会失败并报错 No configuration。
- 首次调试时，确保在 Python 文件中设好断点，然后按
F5，选择环境为Python File，VSCode 会自动生成标准配置 - 生成的
launch.json中关键字段是"module"（用于python -m xxx）和"args"（传参），修改它们比改命令行更安全 - 如果项目含多个入口（如
main.py和test_runner.py），建议为每个入口单独建一个配置项，避免反复编辑
真正卡住人的往往不是“怎么配”，而是解释器路径没生效、扩展未启用、或者终端用的是 PowerShell 而不是 Bash 导致 python 命令不可用 —— 遇到运行失败，先看左下角解释器路径是否正确，再看终端里 which python 或 where python 返回什么。
