在 VS Code 中试用

在 Visual Studio Code 中运行 Python 代码

无论你是在 REPL 中尝试少量 Python 代码,还是准备运行 Python 脚本,Python 扩展都提供了多种运行代码的方式。

交互式运行 Python 代码

机器上安装的 Python 解释器提供了所谓的交互式 REPL(读取-评估-打印循环),它读取一段代码,评估它,然后将结果打印到控制台。

在机器上安装 Python 解释器后,你可以通过打开系统上的终端或命令提示符,输入 python (Windows) 或 python3 (macOS/Linux) 来激活 Python REPL,REPL 由 >>> 表示。

在 VS Code 中,还有两种与 Python REPL 交互的方式。

原生 REPL

适用于 Python 的 VS Code 原生 REPL 基于经典的 Python REPL 构建,并提供了智能感知和语法高亮等附加功能,使你的 Python 开发体验更高效。然而,此 REPL 仍然遵循 Python 自身内置 REPL 的原则,即历史执行顺序及其内容是不可变的。

你可以通过命令面板(⇧⌘P (Windows、Linux Ctrl+Shift+P))搜索“Python: 启动原生 REPL”来打开原生 REPL。此外,你可以在 settings.json 文件中将 "python.REPL.sendToNativeREPL" 设置为 true,通过智能发送(Shift+Enter)和“在 Python REPL 中运行选择/行”将代码发送到原生 REPL。通过将 "python.REPL.sendToNativeREPL" 设置为 false,你可以选择继续使用终端中内置的 Python REPL(>>>)。

Gif showing the Native REPL for Python.

终端 REPL

与在 VS Code 外部与 Python REPL 交互的方式类似,你可以在 VS Code 中打开一个终端并激活 Python REPL。为此,你可以在命令面板(⇧⌘P (Windows、Linux Ctrl+Shift+P))中搜索“Python: 启动终端 REPL”,这将为当前选定的 Python 解释器打开一个终端。或者,你可以导航到“终端 > 新建终端”并输入 python (Windows) 或 python3 (macOS/Linux) 命令。

终端通过终端 Shell 集成支持多项功能,例如运行最近的命令、命令装饰器和改进的辅助功能。要启用或禁用终端中的 Shell 集成,你可以在设置中切换 python.terminal.shellIntegration.enabled

运行 Python 代码

Python 扩展提供了多种无需额外配置即可运行 Python 代码的方式。

  1. 选择编辑器右上角的“在终端中运行 Python 文件”播放按钮。

    Using the Run Python File in Terminal button

    此按钮会打开一个终端面板,其中你的 Python 解释器会自动激活,然后运行指定的脚本(例如,python3 hello.py (macOS/Linux) 或 python hello.py (Windows))。

    Program output in a Python terminal

  2. 在编辑器窗口中任意位置右键单击,然后选择“运行 > 在终端中运行 Python 文件”(此操作会自动保存文件)。

    Run Python File in Terminal command in the Python editor

  3. 选择一行或多行,然后按 Shift+Enter,或右键单击并选择“在 Python 终端中运行选择/行”。

    此选项便于只测试文件的一部分。

  4. 将光标放在代码行上,然后按 Shift+Enter 以激活智能发送。

智能发送

Python 扩展默认启用智能发送(Shift+Enter)。智能发送会查看光标所在的代码,将最小的可运行代码块发送到 Python REPL,然后将光标定位到下一行代码。这使你能够轻松高效地在程序中运行 Python 代码。

智能发送不适用于不受支持的 Python 版本(例如 Python 2)或无效的 Python 代码。若要禁用智能发送,仅发送光标所在行的代码,请将 python.REPL.enableREPLSmartSend 设置为 false

另请参阅

  • 调试 - 了解如何在本地和远程调试 Python。
  • 测试 - 配置测试环境并发现、运行和调试测试。