PyCharm和VS Code中怎么运行Python脚本
详细讲解在PyCharm与VS Code两款主流工具中运行Python脚本的核心机制、常用操作方法、快捷键以及环境配置与常见问题排查。
运行 Python 脚本的本质,是让系统中的 Python 解释器读取 .py 代码文件并逐行编译执行。在 PyCharm 与 VS Code 这两款主流开发工具中,运行脚本的核心区别在于集成度与工作流设计:PyCharm 作为开箱即用的专业集成开发环境(IDE),内置了完整的项目运行与解释器管理逻辑;而 VS Code 作为轻量化代码编辑器,依赖官方 Python 扩展与内置终端完成环境绑定与指令调用。无论使用哪一款工具,最关键的先决条件均是为当前项目明确指定可用的 Python 解释器路径,随后即可通过图形按钮、快捷键或终端命令等多种方式触发执行。
一、运行 Python 脚本的底层逻辑与环境检查
很多初学者在运行脚本时遇到报错,往往误以为是编辑器的问题,实际上是由于“编辑器未能关联到正确的 Python 解释器”,或者“系统终端中执行的 Python 与代码所需的第三方包所在环境不一致”。因此,在学习点击运行按钮之前,必须先理清代码从编辑器到最终执行的完整链条。
无论是点击绿色三角形图标,还是在终端中敲下回车,工具所做的事情都是:调用选定环境下的 python.exe(或 macOS/Linux 下的 python3),并将当前脚本文件的绝对路径作为参数传入。如果当前环境缺少脚本引用的第三方库(如 requests 或 numpy),程序便会中断并抛出 ModuleNotFoundError。
二、在 PyCharm 中运行 Python 脚本的四种方式
PyCharm 会在项目根目录维护一个解释器配置。当你在 PyCharm 中首次打开或新建一个包含 Python 文件的项目时,它会自动检测系统中的 Python 或创建虚拟环境(Virtualenv)。完成配置后,可以通过以下几种最常用的方式运行脚本:
1. 编辑区或文件目录右键运行(首次运行最推荐)
这是最直接、最不容易出错的运行方式。当新建了一个名为 demo.py 的文件后:
- 在编辑区域的任意空白处点击鼠标右键,或者在左侧项目工程树(Project Tool Window)中右键点击该文件。
- 在弹出的上下文菜单中,找到带有绿色播放箭头的 Run 'demo' 选项并点击。
- 此时 PyCharm 底部会自动弹出 Run 工具窗口,显示运行脚本的完整命令及打印输出结果。
2. 使用键盘快捷键执行
熟练使用快捷键能极大提升编码与测试效率。PyCharm 提供了两组核心运行快捷键:
- 运行当前打开的文件: Windows/Linux 下按下
Ctrl + Shift + F10;macOS 下按下Control + Shift + R。该快捷键会直接针对当前激活的编辑器选项卡创建或切换运行配置并启动。 - 重跑上一次执行过的脚本: Windows/Linux 下按下
Shift + F10;macOS 下按下Control + R。即使你当前正在查看其他文件,该快捷键也会继续重新运行右上角配置框中锁定的脚本。
3. 右上角运行配置面板与绿色三角按钮
当通过右键运行过一次脚本后,PyCharm 会自动在窗口右上角的工具栏中生成对应的“运行/调试配置”(Run/Debug Configuration):
- 下拉框中会显示当前选中的脚本名称。
- 直接点击旁边的绿色三角形图标(Run)即可运行,点击绿色爬虫图标则进入 Debug 模式。
- 若脚本需要接收命令行参数(如
python demo.py --batch 10),可以点击下拉菜单中的 Edit Configurations...,在Parameters栏填入参数,在Working directory中指定运行工作目录。
4. 内置终端(Terminal)执行原生命令
点击 PyCharm 底部工具栏的 Terminal 标签页,或者使用快捷键 Alt + F12(macOS 为 Option + F12)调出终端。PyCharm 的内置终端会自动激活当前项目所配置的虚拟环境(命令行提示符前会显示 (.venv) 字样)。此时输入标准的终端执行命令:
python demo.py
按下回车即可运行。这种方式与线上生产环境的执行体验完全一致。
三、在 VS Code 中运行 Python 脚本的标准步骤
VS Code 本身是一个纯文本编辑器。要流畅运行 Python 代码,必须经过安装扩展、选择解释器、触发执行三个阶段。
1. 前期准备:安装官方 Python 扩展
首次使用 VS Code 时,点击左侧活动栏的扩展图标(或按 Ctrl + Shift + X / macOS Cmd + Shift + X),在搜索框输入 Python,找到由 Microsoft 官方发布的扩展并点击 Install。该扩展为 VS Code 提供了代码补全、调试、解释器选择以及一键运行能力。
2. 核心设置:选择当前项目的 Python 解释器
打开项目文件夹后,VS Code 需要明确当前代码在哪个 Python 环境下运行:
- 按下快捷键
Ctrl + Shift + P(macOSCmd + Shift + P)调出命令面板。 - 输入
Python: Select Interpreter并按回车。 - 在出现的列表中,选择你的 Python 安装路径或当前项目专属的虚拟环境(通常标记为
('venv': venv)或Recommended)。 - 选定后,VS Code 右下角状态栏会显示当前生效的 Python 版本(如
3.11.8 64-bit ('venv': poetry))。
3. 运行方式一:编辑器右上角“运行 Python 文件”按钮
打开需要运行的 .py 文件,查看编辑窗口的右上角。官方扩展会自动在此处添加一个播放箭头按钮:
- 点击该三角按钮,下拉菜单中选择 Run Python File(或直接点击图标)。
- VS Code 会自动在底部开启一个内置终端,自动激活所选虚拟环境,并输出形如
& /path/to/python /path/to/script.py的命令直接运行。
4. 运行方式二:编辑器内右键快捷运行
在代码编辑区域点击鼠标右键,在上下文菜单中选择 Run Python -> Run Python File in Terminal。其效果与点击右上角运行按钮一致。
5. 运行方式三:交互式逐行/代码块执行(Shift + Enter)
如果你在进行数据分析或算法调试,往往不需要每次都从头运行整个文件:
- 用鼠标选中某几行代码,或者将光标停留在某一行。
- 按下快捷键
Shift + Enter。 - VS Code 会在右侧或底部呼出 Python Interactive 交互窗口或启动 REPL 进程,仅执行选中的代码段并保持变量常驻内存。
四、两款工具核心运行差异对比
为了帮助读者在不同项目中选用合适的工具,下表总结了 PyCharm 与 VS Code 在运行 Python 脚本时的关键特性差异:
| 对比维度 | PyCharm (专业/社区版) | VS Code (配合官方扩展) |
|---|---|---|
| 运行机制 | 基于内部 Run Configuration 配置系统,统一由 Run 窗口接管输出。 | 直接调用系统的终端外壳(PowerShell/Bash/zsh)发送命令行执行。 |
| 环境感知 | 每个项目深度绑定单一 SDK,自动管理项目虚拟环境与依赖索引。 | 通过工作区或全局配置切换解释器,支持快速在状态栏一键更换。 |
| 参数配置 | 在 Edit Configurations 界面提供完整的图形化输入框(参数、工作目录、环境变量)。 | 可通过配置 .vscode/launch.json 文件设定 args 与 cwd。 |
| 多文件交互 | 支持为每一个脚本独立保存一份运行配置,方便快速切换不同入口。 | “运行 Python 文件”始终动态指向当前聚焦的活动选项卡文件。 |
| 资源占用 | 启动较重,具备强大的后台代码分析与即时检查能力。 | 轻量敏捷,随开随走,适合单个脚本或轻度调试任务。 |
五、运行脚本常见问题与排查指南
1. 报错 ModuleNotFoundError: No module named 'xxx'
原因:你在系统命令行安装了该库(例如通过 pip install xxx 安装在全局 Python),但当前工具运行脚本所使用的是另一个干净的虚拟环境;或者在虚拟环境中安装了库,IDE 却指向了系统默认环境。
排查方法:在脚本顶部加入两行调试代码:
import sys; print(sys.executable)
运行后观察输出的路径是否为你安装第三方库的那个环境。在 PyCharm 中检查 Settings -> Project -> Python Interpreter;在 VS Code 中重新按下 Ctrl + Shift + P 执行 Python: Select Interpreter 进行校正。
2. 相对路径读取文件报错 FileNotFoundError
原因:Python 解析相对路径(如 open('data/info.txt'))时,并不是以脚本所在的文件夹为基准,而是以当前工作目录(Current Working Directory, CWD)为基准。如果从项目根目录运行子目录下的脚本,CWD 会是根目录,导致子路径失效。
排查方法:在 PyCharm 中,检查运行配置中的 Working directory 是否设置正确;在 VS Code 中,建议在代码中使用动态绝对路径锚定文件位置:
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent
3. 点击运行无反应或终端提示 python : 无法将“python”项识别为 cmdlet
原因:在安装 Python 时未勾选“Add Python to PATH”(添加到系统环境变量),导致系统的 Shell 终端无法识别 python 命令。
排查方法:在 Windows 系统属性的高级设置中,将 Python 的安装目录及 Scripts 目录添加到系统环境变量 PATH 中;或者直接在 VS Code 与 PyCharm 中手动浏览并指定具体 python.exe 路径,跳过系统 PATH 解析。
总结
在 PyCharm 与 VS Code 中运行 Python 脚本,虽然界面与交互形式各有侧重,但底层本质完全相通。对于希望省心管理大型工程、享受完备调试和环境隔离的开发者,PyCharm 的运行配置系统能提供极高的稳定性;而对于追求启动速度、喜欢在命令行环境中灵活组合工具的开发者,VS Code 配合官方 Python 插件则更加轻便高效。掌握解释器绑定与终端调用的基本逻辑后,便能在任何工具中从容应对脚本运行与调试工作。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













