Python 教程 / 在 VS Code 选择解释器、运行与调试代码

在 VS Code 运行 Python,既要安装编辑器和 Python 扩展,也要为项目选择真正执行代码的解释器。打开项目文件夹并选定它的虚拟环境,再核对终端中的 Python 与 pip 路径,才能避免“已经安装包却无法导入”的环境错配。

准备编辑器与项目文件夹

本课假定已安装 Python,并为 python-lab项目创建了 .venv。Windows 准备方法见安装 Python 并验证解释器,macOS 与 Ubuntu 的区别见准备运行环境。

VS Code 负责编辑文件;Python 解释器负责执行程序;Microsoft 的 Python 扩展把解释器选择、运行等功能接入编辑器。这三者作用不同,安装编辑器或扩展不等于安装了 Python 本身。在扩展视图中搜索 Python,核对发布者为 Microsoft,再安装相应扩展。

通过 File → Open Folder(文件 → 打开文件夹)打开 python-lab,不要只打开其中一个文件。文件夹是工作区的基础,也便于判断终端当前目录、源文件位置和相对路径。只打开文件时,终端未必位于你以为的项目目录。

VS Code 官方 Python 入门说明列出了编辑器、扩展与解释器的准备步骤。界面语言可能不同,下文保留关键命令的英文名称,便于在命令面板搜索。

选择解释器并核对终端

  1. 用 Windows、Linux 的 Ctrl+Shift+P或 macOS 的 Cmd+Shift+P打开命令面板,运行 Python: Select Interpreter。
  2. 选择当前项目 .venv中的解释器。未列出时,使用输入解释器路径的选项,定位到该环境实际存在的 Python 文件。
  3. 打开新的集成终端,执行下面两条检查命令。
python -c "import sys; print(sys.executable)"
python -m pip --version

Windows 的目标通常是项目下的 .venv\Scripts\python.exe,macOS、Ubuntu 则是 .venv/bin/python。第二条命令显示的 pip 文件位置也应位于同一个环境。只看到一个熟悉的版本号还不够:两份不同的安装可以使用相同版本。

选择解释器后,已有终端可能仍保留旧环境;新终端也应通过实际输出确认,不要仅凭状态栏名称推断已经激活。如果终端命令没有指向项目环境,可以直接调用该环境解释器的完整路径执行同样的参数。这样无需修改系统 PATH,也不依赖当前 shell 的激活状态。

官方 Python 环境管理说明介绍了环境发现、选择与终端的关系。一个工作区有多个项目时,要确认选中的是当前源文件对应项目的环境。

保存并运行完整脚本

在项目文件夹中新建 expense.py,使用 UTF-8 保存下面的完整内容。文件应与 .venv分开保存,而不是写进虚拟环境目录。

amounts = [3500, 8000, 2500]
total = sum(amounts)
print(f"total={total}")

在已经核对环境、当前目录为项目目录的终端执行 python expense.py;也可以在编辑器中打开并保存该文件,运行 Python 扩展的 Run Python File in Terminal命令。在 macOS、Ubuntu 的虚拟环境之外,解释器命令可能是 python3,应依据实际路径检查选择。预期输出为:

total=14000

列表保存三笔金额,sum(amounts)计算合计,f 字符串把结果放进输出文本。把第二个金额由 8000改成 9000,保存并再次执行,输出应变为 total=15000;恢复原值后应回到 total=14000。每次只改一个值,便于把输出变化与输入对应起来。

运行结果不符时,再核对解释器与 pip:

python -c "import sys; print(sys.executable)"
python -m pip --version

如果提示找不到 expense.py,先检查当前终端文件夹、实际文件名以及是否意外保存为 expense.py.txt。若输出一直未变,确认保存了修改,且运行的是编辑器中这份文件,而不是另一个目录的同名副本。

用断点检查变量并排查环境不一致

在输出语句 print(...)左侧的行号边栏单击,放置断点;按 F5或使用 Run → Start Debugging 启动调试。首次出现调试器与配置选择时,选择 Python Debugger 和当前 Python 文件。Python Debugger 扩展通常随 Python 扩展安装,可在扩展视图核对。

程序停在输出语句时,该行尚未执行,但上一行的合计已经算好。此时在 Variables(变量)视图查看 amounts与 total,应分别为三笔金额和 14000。按 F10单步越过当前行,观察终端输出,再继续执行到结束。不要把断点放在合计赋值之前却期待变量已经存在。

调试只用于观察程序状态,并不改变求和规则。Python 调试官方说明介绍了断点、调试器选择和配置。如果项目已有 launch.json,也要检查其中是否指定了不同解释器或工作目录。

  • 安装第三方包后导入失败:比较执行程序和 python -m pip的路径,确认属于同一 .venv。
  • 导入到了意外文件:检查项目是否使用 json.py、csv.py等标准库名称作为自己的文件名,从而遮蔽标准模块。
  • 编辑器运行与终端结果不同:检查保存状态、文件路径、解释器和工作目录,逐项排除差异。
  • 其他扩展的运行按钮行为不同:先以 Python 扩展的运行命令和已经核对的项目终端为基准,再检查其他工具的配置。