在PyCharm和VS Code中怎么运行Python程序

小林子
小林子
发布时间:2026-11-13| 8人浏览过
原创

详细讲解在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 并按下回车键,即可通过原生命令行方式执行该脚本。
在PyCharm和VS Code中怎么运行Python程序
图 1:PyCharm 运行 Python 代码的核心步骤与界面交互流程
提示:在 PyCharm 中运行后,底部会出现名为 Run 的控制台窗口。窗口最后一行若显示 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 代码前,需完成扩展安装:

  1. 点击 VS Code 左侧活动栏中的 Extensions(扩展)图标(快捷键 Ctrl + Shift + X,macOS 为 Cmd + Shift + X)。
  2. 在顶部搜索框输入 Python。
  3. 在搜索结果中找到由 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程序
图 2:VS Code 运行 Python 程序的核心链路与操作方式

三、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 后端开发、注重包管理 中小型脚本、日常数据分析、轻量化快速验证、跨语言开发
在PyCharm和VS Code中怎么运行Python程序
图 3:PyCharm 与 VS Code 运行机制与执行架构对比示意图

四、运行 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程序
图 4:Python 程序运行异常诊断与排查决策树指南

五、总结与使用建议

归纳来看,在 PyCharm 与 VS Code 中运行 Python 程序的关键逻辑是一脉相承的:

  • 如果你追求规范、严谨的项目级管理,希望新建项目时自动隔离虚拟环境,并拥有高度集成的代码跳转与调试控制台,PyCharm 是一步到位的理想选择;首次运行只需在编辑区右键选择 Run 即可。
  • 如果你更看重编辑器的极简轻盈、秒级启动,或是进行跨语言与小脚本开发,VS Code 能够提供极致的灵活性;只需记住安装官方 Python 扩展并通过命令面板绑定解释器,点击右上角的三角形按钮即可快速执行。

只要牢牢抓住“检查当前绑定的 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 算法库。