VS Code和PyCharm中运行Python程序的快捷操作与配置

花开有时
花开有时
发布时间:2026-11-17| 6人浏览过
原创

详细介绍在 Visual Studio Code 与 JetBrains PyCharm 中高效运行 Python 程序的快捷键操作、运行配置(launch.json 与 Run/Debug Configurations)设置方法及常见环境问题排查。

在日常 Python 开发中,Visual Studio Code(VS Code)和 JetBrains PyCharm 是最主流的两种集成开发环境。它们在运行 Python 脚本时的底层机制有所不同:VS Code 侧重轻量插件驱动与终端环境交互,而 PyCharm 采用开箱即用的工程管理与持久化运行配置(Run/Debug Configurations)。熟练掌握两者的运行快捷键、解释器绑定以及高级运行配置,可以有效减少鼠标点击频率,避免由于环境错配引发的执行异常。

一、VS Code 中运行 Python 程序的快捷操作与配置

在 VS Code 中执行 Python 代码前,必须确保已安装微软官方的 Python 扩展插件。运行 Python 脚本的核心依赖于当前工作区绑定的解释器,代码实际在 VS Code 内置的集成终端中执行。

1. 解释器选择与环境绑定

打开 Python 项目文件夹后,按下快捷键 Ctrl + Shift + P(macOS 上为 Cmd + Shift + P)调出命令面板,输入并选择 Python: Select Interpreter。在弹出的列表中,根据项目需要选择系统 Python、虚拟环境(.venv)或 Anaconda 环境。选择完成后,VS Code 会在底部状态栏显示当前激活的解释器名称与版本。

2. 常用运行快捷操作

  • 一键运行当前文件:点击编辑器右上角的三角形“在专用终端中运行 Python 文件”按钮。若习惯使用键盘,可通过快捷键设置(Ctrl + K Ctrl + S)为命令 python.execInTerminal 绑定专属快捷键(例如 F5 或自定义为 Shift + F10)。
  • 逐行或选中代码运行(交互式 REPL):在编辑器中高亮选中部分代码,按下 Shift + Enter。VS Code 会自动启动 Python 交互式终端(REPL)并执行选中片段,适合调试算法或检验单条语句逻辑。
  • 直接启动调试运行:按下 F5。若未创建配置文件,选择“Python Debugger: Python File”即可对当前活动文件启动断点调试。
VS Code和PyCharm中运行Python程序的快捷操作与配置
图 1:VS Code 运行 Python 程序的四个核心环节

3. launch.json 运行与调试配置

当 Python 脚本需要传递命令行参数、设置专用环境变量或指定当前工作目录(CWD)时,应当在项目根目录下的 .vscode/launch.json 中进行配置。点击左侧活动栏的“运行和调试”图标(Ctrl + Shift + D),点击“创建 launch.json 文件”,添加如下配置示例:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: 运行当前文件(带参数)",
      "type": "debugpy",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "args": ["--mode", "debug", "--batch-size", "32"],
      "cwd": "${workspaceFolder}",
      "env": {
        "PYTHONPATH": "${workspaceFolder}"
      }
    }
  ]
}

配置中,${file} 指向当前活跃编辑器中的文件;${workspaceFolder} 保证脚本始终以项目根目录作为当前路径运行,有效防止相对文件路径读取失败。

二、PyCharm 中运行 Python 程序的快捷操作与配置

PyCharm 作为全功能的 Python 专业 IDE,拥有完善的“运行/调试配置”(Run/Debug Configurations)体系。任何脚本在运行后都会自动生成一份持久化的配置项,方便重复调用或微调参数。

1. 常用运行快捷键

  • 首次运行当前文件:在当前编辑的代码区域内,按下 Ctrl + Shift + F10(macOS 上为 Control + Shift + R)。该操作会立即为当前文件生成临时运行配置并执行代码。
  • 重复运行上次配置:按下 Shift + F10(macOS 上为 Control + R)。无论当前焦点停留在哪个文件,IDE 都会直接重新运行顶部工具栏当前选中的目标配置。
  • 调试运行:首次调试当前文件使用 Ctrl + Shift + F9;重复调试当前选中配置使用 Shift + F9(macOS 上为 Control + D)。
  • 在 Python 控制台中执行片段:选中任意代码,按下 Alt + Shift + E(macOS 上为 Option + Shift + E),代码会被发送到下方的“Python Console”独立交互式运行,保留上下文变量。
VS Code和PyCharm中运行Python程序的快捷操作与配置
图 2:PyCharm 运行配置项与触发链路

2. Run/Debug Configurations 界面配置详解

当项目包含复杂调用时,可通过顶部导航栏的下拉菜单点击 Edit Configurations... 进入图形化配置面板。关键配置字段如下:

  • Script path:指定要执行的主脚本入口文件(如 main.py)。亦可切换为 Module name(如以模块方式运行 uvicorn.main)。
  • Parameters:输入命令行参数,参数之间以空格分隔。例如 --dataset coco --epochs 50 --lr 0.001。
  • Environment variables:设置运行期环境变量(如 CUDA_VISIBLE_DEVICES=0;APP_ENV=dev),无需污染系统全局环境变量。
  • Python Interpreter:指定该配置专用的 Python 解释器。若项目针对不同子模块使用不同的虚拟环境,可在此独立指定。
  • Working directory:程序执行时所在的基准工作目录。默认为当前脚本所在目录或工程根目录,建议设置为包含配置文件的工程顶级目录。

三、VS Code 与 PyCharm 运行方式与快捷键对照

为了帮助从一种编辑器切换或同时在两个环境中开发的读者快速建立肌肉记忆,以下将常用运行场景的默认快捷键及操作逻辑进行归纳对照。

操作场景 VS Code 默认操作 / 快捷键 PyCharm 默认快捷键 (Win/Linux) PyCharm 默认快捷键 (macOS)
运行当前文件 右上角运行 ▶ / 需绑定 python.execInTerminal Ctrl + Shift + F10 Control + Shift + R
重新运行上次配置 在终端按方向键 ↑ 回车 / 按 F5 Shift + F10 Control + R
调试当前文件 F5(选择 Python Debugger) Shift + F9 Control + D
交互式运行选中代码 Shift + Enter Alt + Shift + E Option + Shift + E
切换 Python 解释器 Ctrl+Shift+P > Select Interpreter 右下角状态栏点击解释器名称切换 右下角状态栏点击解释器名称切换
高级参数与环境变量 编辑 .vscode/launch.json 文件 图形化 Edit Configurations... 对话框 图形化 Edit Configurations... 对话框
VS Code和PyCharm中运行Python程序的快捷操作与配置
图 3:VS Code 与 PyCharm 核心运行机制差异

四、常见运行异常与避坑指南

在日常运行 Python 脚本时,开发者最常遇到的问题往往并非代码语法错误,而是由工作目录不一致、虚拟环境未正确激活或多环境版本冲突导致的运行时异常。

1. 终端环境与 IDE 解释器不一致

现象多表现为:在 IDE 编辑器中提示模块存在(无警告),但一运行就抛出 ModuleNotFoundError;或者在外部终端能正常运行,但在 IDE 快捷运行中报错。原因在于系统默认终端执行的 python 与 IDE 当前绑定的 Python 可执行文件路径不同。

自查命令
在执行失败的终端或脚本开头加入以下代码打印环境信息: import sys; print(sys.executable) 核对输出的路径是否指向目标虚拟环境目录(如 .../venv/bin/python 或 .../venv/Scripts/python.exe)。

2. 相对路径读取失败(FileNotFoundError)

在 Python 中使用 open("data/config.json") 等相对路径读取资源时,相对路径的基准并不是当前 .py 脚本所在的目录,而是当前工作进程启动时的工作目录(CWD)。

  • VS Code:在 .vscode/launch.json 中明确显式配置 "cwd": "${workspaceFolder}"。
  • PyCharm:在 Edit Configurations 中,将 Working directory 设置为项目的根目录,或者在代码中通过 pathlib.Path(__file__).resolve().parent 构造绝对路径。
VS Code和PyCharm中运行Python程序的快捷操作与配置
图 4:Python 运行配置核心要点与排查总结

掌握以上快捷操作与配置逻辑后,不论是在 VS Code 的轻量灵动中探索原型,还是在 PyCharm 的严谨工程中构建服务,都能快速启动代码、精准定位运行环境并大幅提升日常编码效率。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。