PyCharm和VS Code怎么运行Python程序

林见深
林见深
发布时间:2026-11-17| 7人浏览过
原创

详细讲解PyCharm与VS Code运行Python程序的核心原理、完整操作步骤、多种运行方式与常见报错排查,帮助初学者快速掌握Python代码执行与环境配置。

运行 Python 程序的核心逻辑十分纯粹:让计算机中安装的 Python 解释器去解析并执行你编写的代码文件。PyCharm 和 VS Code(Visual Studio Code)是当今最主流的两种 Python 开发工具。PyCharm 是专为 Python 打造的集成开发环境(IDE),开箱自带完整的工程体系与运行控制台;而 VS Code 则是高度灵活的现代代码编辑器,通过安装官方扩展与配置解释器实现轻量高效的运行。只要理清“选择解释器”与“触发运行”这两步,在这两款工具中运行 Python 都会变得非常直接。

PyCharm和VS Code怎么运行Python程序
图1:Python 程序在开发工具中的执行链路与核心架构

一、准备工作:理解 Python 解释器的角色

无论是 PyCharm 还是 VS Code,本身都只是代码编辑工具,不能脱离 Python 解释器单独执行 Python 代码。计算机运行代码的底层本质是:编辑器通过系统调用命令 python 文件名.py,把代码送入对应的 Python 引擎中编译为字节码并逐行解释执行。

因此在开始之前,确保计算机系统已经安装了 Python:

  • 在操作系统终端(Windows 的 CMD / PowerShell,或 macOS / Linux 的 Terminal)中输入 python --version 或 python3 --version。
  • 如果能够正确打印出版本号(例如 Python 3.11.8),说明 Python 已经就绪。

二、在 PyCharm 中运行 Python 程序

PyCharm 是由 JetBrains 开发的重型 IDE,对 Python 项目有完整的工程管理模型。只要项目解释器配置完毕,运行代码只需一键即可。

PyCharm和VS Code怎么运行Python程序
图2:PyCharm 运行 Python 程序操作全流程

1. 配置或检查解释器

首次运行脚本若提示没有解释器,可通过以下路径设置:

  • 打开菜单栏:Windows 上点击 File > Settings;macOS 上点击 PyCharm > Settings / Preferences。
  • 在左侧列表中导航至 Project: [你的项目名] > Python Interpreter。
  • 点击右上角的 Add Interpreter,选择 Add Local Interpreter。
  • 如果使用虚拟环境,选择 Virtualenv Environment 并指定 Python 基础版本;或者选择 System Interpreter 直接使用系统全局 Python。
  • 点击 OK 保存,等待右下角索引建立完成。

2. 运行代码的具体操作

编写示例代码(如 main.py):

# main.py
def calculate_sum(a, b):
    return a + b

if __name__ == "__main__":
    result = calculate_sum(10, 25)
    print(f"计算结果为: {result}")

执行该文件有以下四种最常用的方式:

  1. 右键菜单运行(最推荐初学者):在代码编辑区的任意空白区域点击鼠标右键,在弹出菜单中点击 Run 'main'(或使用快捷键 Ctrl+Shift+F10,macOS 为 Control+Option+R)。
  2. 右上角运行工具栏:当文件曾被运行过一次后,PyCharm 会自动将其加入右上角运行配置下拉框。直接点击旁边的绿色三角形图标(快捷键 Shift+F10,macOS 为 Control+R)即可再次运行。
  3. 代码左侧行号绿三角:在包含 if __name__ == '__main__': 的代码行左侧边栏,会出现一个带有圆形底衬的绿色小三角,点击它并选择 Run 'main'。
  4. 内置 Terminal 命令行:点击 PyCharm 底部窗口栏的 Terminal 标签页,终端会自动激活该项目的虚拟环境,在命令行中输入 python main.py 并回车。

运行后,PyCharm 底部会自动弹出 Run 面板,展示执行路径、程序标准输出以及进程退出码 Process finished with exit code 0(退出码为 0 代表运行成功无异常)。

三、在 VS Code 中运行 Python 程序

VS Code 是一款基于插件机制的现代轻量代码编辑器。要流畅运行 Python,需要先安装微软官方的 Python 扩展插件,并通过状态栏或命令面板绑定解释器。

PyCharm和VS Code怎么运行Python程序
图3: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(macOS 为 Cmd+Shift+P)调出顶部命令面板。
  • 在输入框中键入 Python: Select Interpreter 并按回车。
  • VS Code 会自动扫描本机已经安装的 Python 版本、虚拟环境或 Conda 环境,点击选用目标解释器即可。
  • 成功绑定后,窗口右下角状态栏会显示当前所选解释器版本号(如 3.10.12 ('venv': venv))。

3. 运行代码的具体方式

使用 File > Open Folder 打开一个工作目录并新建 app.py,可通过以下几种常见方式运行:

  1. 右上角三角形运行按钮:打开 .py 文件后,编辑器窗口右上角会出现一个三角形的“Play”图标。点击下拉菜单并选择 Run Python File。VS Code 会自动在下方拉起集成终端,激活对应的环境并打印执行结果。
  2. 右键菜单执行:在编辑区域内右键单击,在弹出的菜单中选择 Run Python > Run Python File in Terminal。
  3. 选中代码部分运行(Shift+Enter):高亮选中你想要测试的代码行,按下 Shift+Enter,VS Code 会在集成终端中启动 Python 交互式 REPL 会话并只执行选中的那几行,非常适合临时验证逻辑。
  4. 调试模式启动(F5 与 Ctrl+F5):按下 F5 可以启动内置调试器,支持断点单步排查;如果不需要打断点只想纯粹运行,按下快捷键 Ctrl+F5 即可快速执行。

四、进阶知识:调试模式与虚拟环境

日常开发不仅是简单运行代码,掌握断点调试与虚拟环境隔离同样必不可少:

  • 断点调试(Debug):在代码行号左侧单击可以点亮一个红色圆点(断点)。运行调试后,程序会在断点处暂停,此时可在 PyCharm 的 Debug 面板或 VS Code 的 Run and Debug 侧边栏中实时查看所有变量的当前值、调用栈,并进行单步步过(Step Over)、步入(Step Into)操作。
  • 虚拟环境隔离:不同项目依赖的第三方库版本各不相同。PyCharm 默认建议在创建项目时创建专属 venv;而 VS Code 也会自动检测当前项目目录下的 .venv 文件夹并提示使用。保证每个项目在独立虚拟环境中运行,能彻底规避库版本冲突。

五、常见运行报错与排查清单

在运行 Python 程序时,如果遇到报错,可以按照以下清单逐项排查:

常见报错 / 异常表现 根本原因 具体解决办法
No Python interpreter configured / 未配置解释器 IDE 未与本机安装的 Python 建立路径关联。 PyCharm 进入 Settings > Python Interpreter 添加本地解释器;VS Code 按 Ctrl+Shift+P 搜索 Select Interpreter 绑定环境。
ModuleNotFoundError: No module named 'xxx' 使用的库未安装在当前解释器中,或安装时混淆了全局与虚拟环境。 在当前 IDE 内置的 Terminal 中执行 pip install xxx,确保安装目标与当前选中的解释器保持一致。
'python' 不是内部或外部命令 系统 PATH 环境变量中未添加 Python 及 Scripts 安装路径。 重新运行 Python 安装包,务必勾选“Add python.exe to PATH”,或手动在系统环境变量中添加 Python 根目录。
代码运行一闪而过无输出 脚本末尾无输出打印或执行速度过快自动退出。 在 IDE 内置控制台或终端中运行即可保留完整输出;或在脚本末尾加上 print("完成") 确认执行流程。

六、PyCharm 与 VS Code 的特性与选型对比

了解两者的机制差异,有助于根据项目场景做出更合理的开发选择:

PyCharm和VS Code怎么运行Python程序
图4:PyCharm vs VS Code 运行体验与选型矩阵

无论是选用专注于 Python 生态的 PyCharm,还是选用轻巧灵活的 VS Code,运行代码的核心逻辑是一致的:确保 Python 环境正确安装 -> 在软件中指定目标解释器 -> 触发运行并从控制台查看输出。理顺这一工作流后,便能根据日常学习、脚本编写或大型工程的不同需要,自如切换并高效执行代码。

相关专题:

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

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 算法库。