VSCode怎么运行Python代码_VSCode如何配置并执行Python脚本程序【指南】

找不到Python解释器路径时，需通过“Python: Select Interpreter”手动指定，如列表为空则用“Enter interpreter path...”输入准确路径（macOS/Linux为/usr/bin/python3等，Windows为Python安装目录下的python.exe），配置将写入.vscode/settings.json。

找不到 Python 解释器路径怎么办

VSCode 运行 Python 的第一步不是按 F5，而是让编辑器知道 python 命令在哪。常见现象是点击右上角「运行」按钮后弹出提示：Python interpreter not selected，或者终端里报错 command 'python' not found。

本质是 VSCode 没法定位到你系统里装的 Python 可执行文件——它不读系统 PATH，也不自动猜。必须手动指定。

• 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入并选择：Python: Select Interpreter
• 如果列表为空或没出现你想要的版本（比如 python3.11），点「Enter interpreter path...」，然后手动找：
  • macOS：通常在 /usr/local/bin/python3（Homebrew）或 /opt/homebrew/bin/python3（Apple Silicon）
  • Windows：检查 where python 或 py -3.11 --version 输出，路径类似 C:\Users\XXX\AppData\Local\Programs\Python\Python311\python.exe
  • Linux：常用 /usr/bin/python3 或 /usr/local/bin/python3
• 选完后，VSCode 会在当前工作区生成 .vscode/settings.json，写入类似 "python.defaultInterpreterPath": "/usr/bin/python3" ——这个配置只对本项目生效，别误删

为什么按 F5 调试失败但终端能跑通

这是最典型的混淆点：终端里 python script.py 成功 ≠ VSCode 调试器能跑通。F5 启动的是调试会话（debug），依赖 launch.json 配置，和终端执行逻辑完全不同。

常见错误现象包括：ModuleNotFoundError、No module named '__main__'、断点不触发、程序直接退出无报错。

立即学习“Python免费学习笔记（深入）”；

百灵大模型

蚂蚁集团自研的多模态AI大模型系列

下载

• 默认情况下 VSCode 不自动生成 launch.json，必须先按 Ctrl+Shift+D 打开调试面板 → 点「create a launch.json file」→ 选「Python File」
• 关键字段是 "module" 和 "args"：
  • 想运行当前文件？确保 "module": "runpy" 或更稳妥地用 "program": "${file}"
  • 脚本依赖相对路径导入？加 "cwd": "${workspaceFolder}"，否则工作目录可能是用户根目录
  • 需要传参？填 "args": ["--verbose", "input.txt"]，别写成命令行字符串
• 调试器默认启用 justMyCode（跳过标准库），但如果用了 import numpy 后断点进不去，临时关掉它："justMyCode": false

终端里 python -m xxx 报错，VSCode 却能跑

这说明你在终端用的是系统默认 python（可能是 Python 2 或旧版 3.x），而 VSCode 用的是你选的那个解释器（比如 python3.11）。两者环境隔离，包安装位置不同。

典型表现：pip install requests 后，终端报 ModuleNotFoundError: No module named 'requests'，但 VSCode 里 import 正常。

• 永远用解释器对应的 pip：选好解释器后，VSCode 底部状态栏会显示 Python 版本，旁边有个小加号，点它就能用该环境的 pip 安装包
• 命令行验证方式：/path/to/your/python -m pip list，而不是裸跑 pip list
• 虚拟环境务必激活后再选解释器：VSCode 识别 venv 或 conda 环境时，路径要指向 venv/bin/python（macOS/Linux）或 venv\Scripts\python.exe（Windows），不能只选到 venv 文件夹

print() 不输出？stdout 缓冲导致卡住

VSCode 终端里跑脚本时，print("hello") 没反应，或只在程序结束才刷出来，不是代码错了，是 Python 默认对非 TTY 输出做了行缓冲（buffered stdout）。

尤其在用 python -u、子进程、或某些日志库时更容易暴露。

• 临时解决：在 launch.json 里加 "console": "integratedTerminal"，并确保 "env": {"PYTHONUNBUFFERED": "1"}
• 一劳永逸：在代码开头加 import sys; sys.stdout.reconfigure(line_buffering=True)（Python 3.7+）
• 更轻量写法：所有 print() 加 flush=True 参数，比如 print("done", flush=True)
• 注意：VSCode 的「Run Python File in Terminal」快捷键（Shift+F10）默认不带 -u，所以也会缓存；而调试模式（F5）默认开启 unbuffered