在PyCharm和VS Code中怎么运行Python程序
详细讲解在PyCharm与VS Code两款主流开发工具中运行Python程序的具体操作步骤、解释器环境配置、常用运行快捷键以及常见报错排查技巧。
运行 Python 程序的核心机制十分清晰:无论使用哪款开发工具,其底层逻辑都是让编辑器或集成开发环境(IDE)调用本地操作系统中已安装的 Python 解释器(例如 python.exe 或 python3),读取并逐行执行指定的 .py 脚本文件。因此,在 PyCharm 和 Visual Studio Code(简称 VS Code)中运行代码,关键动作只有两步:一是为当前工作空间正确绑定 Python 解释器,二是通过界面按钮、右键菜单或快捷键触发运行命令。理解这两款工具在环境管理与运行载体上的细微差异,不仅能让你顺利启动程序,还能在遇到环境冲突或找不到模块时迅速排除故障。
一、在 PyCharm 中运行 Python 程序
PyCharm 是由 JetBrains 开发的专业 Python 集成开发环境。它将项目工程、虚拟环境和运行控制台进行了深度的打包整合。只要项目成功绑定了解释器,PyCharm 就能提供一键式、开箱即用的运行体验。
1. 前提准备:检查与配置 Python 解释器
在 PyCharm 中运行代码前,必须确保当前项目已关联了有效的解释器。操作路径如下:
- Windows / Linux:点击顶部菜单栏的 File > Settings(或按快捷键 Ctrl + Alt + S)。
- macOS:点击左上角 PyCharm > Settings(或按快捷键 Cmd + ,)。
- 在弹出的设置窗口左侧选择 Project: [你的项目名] > Python Interpreter。
- 观察顶部下拉列表:若显示为有效的 Python 版本路径(如 Python 3.10、虚拟环境 venv 或 conda 环境),说明解释器配置正确;若显示为
<No Interpreter>,点击右侧的 Add Interpreter 按钮,选择 Add Local Interpreter,指派系统自带的 Python 或新建一个 Virtualenv 虚拟环境即可。
2. 四种常见的运行操作方式
配置完成后,在 PyCharm 中运行一个 .py 文件通常有以下四种实用方式:
- 方式一:在代码编辑区直接点击右键运行(最推荐)。在打开的代码编辑区空白处,或直接右键点击顶部的文件名标签,在弹出菜单中点击 Run '文件名'(例如
Run 'main')。对应的快捷键为 Windows/Linux 下的 Ctrl + Shift + F10,macOS 下的 Control + Shift + R。使用右键运行后,PyCharm 会自动将该脚本保存为当前选中的运行配置。 - 方式二:使用右上角运行控制栏。当一个文件至少被右键运行过一次后,PyCharm 窗口右上角的运行配置下拉框就会默认记录该文件。此时直接点击右侧绿色的实心三角形 Run 图标(快捷键为 Shift + F10 或 macOS 上的 Control + R),即可快速重新运行。
- 方式三:点击代码行号旁的绿色运行小箭头。如果你的 Python 文件中定义了主入口函数(即包含
if __name__ == '__main__':代码块),PyCharm 会在该代码行的左侧行号区域自动显示一个绿色的播放小箭头。点击该箭头并在浮层菜单中选择 Run 'main' 即可直接启动。 - 方式四:利用底部内置终端(Terminal)执行。点击 PyCharm 底部工具栏的 Terminal 标签,PyCharm 会自动启动一个已预先激活该项目虚拟环境的命令行终端。在终端光标处输入
python main.py并按下回车键,即可通过原生命令行方式执行该脚本。
Process finished with exit code 0,代表程序正常执行完毕;若退出码非零,则说明程序遇到了未捕获的运行时异常,控制台中会标红显示具体的报错行号与调用栈信息。
二、在 VS Code 中运行 Python 程序
Visual Studio Code 本质上是一款轻量级的现代通用代码编辑器。与开箱即用的 PyCharm 不同,VS Code 原生并不包含 Python 的运行工具链。要在 VS Code 中顺利运行 Python 程序,需要完成两项基础准备:安装 Python 扩展插件,并在状态栏中显式指定 Python 解释器。
1. 前提准备一:安装官方 Python 扩展
首次使用 VS Code 运行 Python 代码前,需完成扩展安装:
- 点击 VS Code 左侧活动栏中的 Extensions(扩展)图标(快捷键 Ctrl + Shift + X,macOS 为 Cmd + Shift + X)。
- 在顶部搜索框输入
Python。 - 在搜索结果中找到由 Microsoft 官方发布的扩展插件,点击 Install 完成安装。安装后它会自动加载代码补全、语法检查以及执行调试支持。
2. 前提准备二:指定当前工作区解释器
这是初学者在 VS Code 中运行代码最容易受挫的环节。如果未选择解释器,VS Code 将无法识别本地的第三方库或环境:
- 按下快捷键 Ctrl + Shift + P(macOS 为 Cmd + Shift + P)唤出顶部命令面板。
- 在输入框中键入
Python: Select Interpreter并按回车。 - 列表中会列出本地检测到的所有 Python 环境(包括全局安装路径、Conda 虚拟环境以及当前项目下的
.venv文件夹)。点击选中你需要使用的版本。 - 选择完成后,VS Code 窗口最底部的状态栏右下角会直接显示当前选中的 Python 版本号(如
3.11.4 64-bit或('venv': venv))。
3. 四种运行操作方式
完成插件安装与解释器选择后,打开任何 .py 文件即可开始运行:
- 方式一:点击编辑器右上角的“播放”图标(最常用)。在打开 Python 脚本后,编辑器右上角会出现一个形似播放键的小三角形图标。直接点击它(或点击下三角菜单选择 Run Python File),VS Code 会自动唤醒底部的集成终端(Integrated Terminal),并向终端发送执行命令。
- 方式二:右键菜单在终端中运行。在代码编辑区域的任意位置右键单击,在弹出的上下文菜单中选择 Run Python > Run Python File in Terminal,效果与点击右上角播放图标相同。
- 方式三:交互式逐行/选区运行(Shift + Enter)。如果只想临时验证某几行代码,可以用鼠标选中该部分代码(或将光标置于某一行),然后按下快捷键 Shift + Enter。VS Code 会在底部启动一个交互式 Python 终端(REPL),仅执行你选中的片段,非常适合数据探索与简单逻辑验证。
- 方式四:在集成终端手动输入命令。按下快捷键 Ctrl + `(反引号)打开内置终端,在终端命令行直接输入
python 文件名.py(macOS/Linux 系统通常输入python3 文件名.py),按下回车即可执行。
三、PyCharm 与 VS Code 的运行机制对比与选择
虽然两款工具最终都能让 Python 代码跑起来,但在底层运行架构、环境隔离和交互逻辑上存在根本性的理念差异:
- PyCharm 是“IDE 进程管理模式”:当你点击运行时,PyCharm 内部的进程调度器会直接启动子进程,并将标准输出、标准错误重定向到专属的 Run 窗口 中。你可以针对每个文件分别定制运行参数(Script parameters)、工作目录(Working directory)和环境变量(Environment variables),而且这些配置会被持久化保存在项目的
.idea目录中。 - VS Code 是“终端桥接模式(CLI Bridge)”:VS Code 秉持轻量与透明的原则。点击运行按钮时,它在后台做的事情就是打开系统的 shell(如 PowerShell、cmd 或 zsh),调用虚拟环境的激活脚本,然后发送类似于
& D:/project/venv/Scripts/python.exe d:/project/main.py的纯文本指令。这也意味着,如果你在终端中能成功运行,VS Code 点击运行也必然能成功。
| 对比维度 | PyCharm (IDE 模式) | VS Code (轻量编辑器模式) |
|---|---|---|
| 运行输出载体 | 专用 Run 控制台窗口,支持一键清空与重启 | 系统集成终端(Integrated Terminal),保持标准 Shell 会话 |
| 环境配置门槛 | 开箱即用,图形化引导明确,自动探测环境 | 需手动安装 Python 扩展,并主动选择解释器 |
| 运行参数定制 | 界面顶部点击“Edit Configurations”即可可视化填报 | 可通过 launch.json 配置文件进行参数深度配置 |
| 多文件切换速度 | 右键即配,每个文件独立保留运行历史记录 | 聚焦当前打开文件,右上角按钮随当前激活标签页切换 |
| 适用场景倾向 | 中大型工程、Django/FastAPI 后端开发、注重包管理 | 中小型脚本、日常数据分析、轻量化快速验证、跨语言开发 |
四、运行 Python 程序常见报错与排查指南
无论在 PyCharm 还是 VS Code 中,编写并点击运行后,最常出现的四类故障及其针对性解决方法如下:
1. 提示找不到解释器(No Python interpreter configured)
表现:代码窗口上方出现黄色警告条,提示未配置解释器;或点击运行按钮无响应。
排查与解决:
- 首先在计算机终端中输入
python --version,确认本机已安装 Python。如果系统提示找不到命令,需前往官网下载安装,并在安装界面勾选 Add python.exe to PATH。 - 在 PyCharm 中,前往 Settings > Project > Python Interpreter,点击 Add Interpreter 手动定位到
python.exe。 - 在 VS Code 中,按快捷键 Ctrl + Shift + P,输入
Python: Select Interpreter,手动浏览并选择解释器可执行文件。
2. 提示模块未找到(ModuleNotFoundError: No module named 'xxx')
表现:在系统终端中明明运行了 pip install requests,但在 PyCharm 或 VS Code 中点击运行时,代码却报错 ModuleNotFoundError: No module named 'requests'。
排查与解决:
- 这是最典型的“运行环境与安装环境不一致”问题。你在系统外部全局安装了库,但你的项目使用的是隔离的虚拟环境(venv)。
- 在 PyCharm 中,直接使用界面底部的 Terminal 终端执行
pip install 模块名(PyCharm 会自动将包安装到当前项目绑定的虚拟环境中)。 - 在 VS Code 中,确认右下角状态栏选择的解释器,与当前集成终端提示符前缀括号里的环境名(如
(venv))完全一致。
3. 读取本地文件报找不到路径(FileNotFoundError)
表现:在脚本中写了 open('data.txt'),文件明明就在脚本同级目录下,但运行时报错 FileNotFoundError: [Errno 2] No such file or directory: 'data.txt'。
排查与解决:
- 相对路径的基准是“当前工作目录(CWD, Current Working Directory)”,而非脚本文件所在的文件夹。
- 在 VS Code 中,若你的工作区根目录处于上一层,在终端中直接执行就会导致相对路径偏离。建议在代码中使用基于当前文件的绝对路径锁定目录:
import os
# 获取当前脚本所在文件夹的绝对路径
BASE_DIR = os.path.dirname(os.path.abspath(__file__))
file_path = os.path.join(BASE_DIR, 'data.txt')
with open(file_path, 'r', encoding='utf-8') as f:
content = f.read()
4. 运行后没有任何输出或瞬间结束
表现:点击运行后,控制台只显示了进程启动和退出命令,没有任何文字打印出来。
排查与解决:
- 检查代码中是否缺少
print()语句。如果在文件中只进行了变量计算或函数定义,没有显式输出,控制台自然不会显示任何结果。 - 检查主入口保护块。如果你的可执行逻辑写在
if __name__ == '__main__':内部,请确认该行代码未被拼写错误或被错误的缩进包裹。可以在脚本最首行加入print("程序开始运行...")来快速验证执行流程。
五、总结与使用建议
归纳来看,在 PyCharm 与 VS Code 中运行 Python 程序的关键逻辑是一脉相承的:
- 如果你追求规范、严谨的项目级管理,希望新建项目时自动隔离虚拟环境,并拥有高度集成的代码跳转与调试控制台,PyCharm 是一步到位的理想选择;首次运行只需在编辑区右键选择
Run即可。 - 如果你更看重编辑器的极简轻盈、秒级启动,或是进行跨语言与小脚本开发,VS Code 能够提供极致的灵活性;只需记住安装官方 Python 扩展并通过命令面板绑定解释器,点击右上角的三角形按钮即可快速执行。
只要牢牢抓住“检查当前绑定的 Python 解释器”这一核心锚点,无论未来切换到哪款开发环境,你都能从容应对程序的运行与调试。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









