PyCharm和VS Code中怎么运行Python代码

Theo
Theo
发布时间:2026-11-18| 4人浏览过
原创

详细讲解在PyCharm与Visual Studio Code中运行Python代码的具体操作路径、解释器配置方法、交互式运行方式以及常见报错的排查排查逻辑。

在无论是PyCharm还是VS Code中运行Python代码,核心逻辑只有两步:让编辑器找到正确的Python解释器(python.exe或python3),以及选择对应的执行入口并触发执行命令。由于两个工具的设计理念不同,PyCharm基于项目级配置接管了大部分环境探测,而VS Code依赖扩展插件与工作区文件夹管理,两者的具体点击路径和配置文件有所区别。掌握这两套工具的基础运行、交互运行及环境绑定方式,就能稳定解决日常开发中“点运行没反应”或“提示找不到模块”的问题。

PyCharm和VS Code中怎么运行Python代码
图1:代码编辑器运行Python的核心结构与信息流向

准备工作:编写测试脚本

在进行编辑器操作前,建立一个标准测试文件有助于排查是代码逻辑错误还是软件环境配置错误。创建一个名为 main.py 的文件,写入以下内容:

import sys

def check_environment():
    print("Python 代码运行成功!")
    print("当前使用的解释器路径:", sys.executable)
    print("当前 Python 版本:", sys.version.split()[0])

if __name__ == "__main__":
    check_environment()

这段脚本除了验证运行状态外,还能直接把当前实际调用的解释器路径打印出来,方便核实编辑器当前执行的环境是否符合预期。

在 PyCharm 中运行 Python 代码

PyCharm 是专为 Python 设计的集成开发环境(IDE)。在默认情况下,只要在创建项目时选定了解释器,PyCharm 就会自动处理后续的依赖索引与执行映射。

1. 确认解释器设置

如果刚打开已有项目或脚本,首先需要确认右下角的状态栏是否已显示 Python 版本。如果没有,可以按如下方式绑定:

  • 打开设置:Windows/Linux 用户点击菜单栏 File → Settings(macOS 用户点击 PyCharm → Settings)。
  • 在左侧列表中找到 Project: [当前项目名],展开后选择 Python Interpreter。
  • 在右侧下拉菜单中选择已存在的解释器。如果列表为空,点击 Add Interpreter → Add Local Interpreter,选择系统安装好的 python.exe 或已建好的 venv/bin/python。

2. 四种常见的运行方式

在 PyCharm 中触发代码运行有多种交互方式,不同场景下效率各有侧重:

  • 右键菜单运行(单文件最常用):在打开的 main.py 代码编辑区内任意空白处单击鼠标右键,在弹出菜单中点击 Run 'main'(快捷键通常为 Ctrl+Shift+F10,macOS 为 Ctrl+Shift+R)。该操作会自动为当前文件创建一套独立的运行配置(Run Configuration)。
  • 顶部工具栏绿色三角:右上角出现 main 配置项后,直接点击旁边的绿色三角按钮(Shift+F10 / Ctrl+R)即可重复执行。
  • 行号左侧运行图标:如果代码中包含 if __name__ == "__main__": 结构,PyCharm 会在该行左侧的行号旁显示一个小型绿色播放三角形,点击后选择 Run 'main' 即可。
  • 交互式控制台运行(单行/选中块):选中一段代码后,按下快捷键 Alt+Shift+E(macOS 为 Option+Shift+E),选中的内容会直接发送到内置的 Python Console 中执行并保留变量状态,适合快速查看数据结构。
PyCharm和VS Code中怎么运行Python代码
图2:PyCharm中执行Python脚本的标准操作与生命周期流程

运行后,底部弹出的 Run 窗口输出内容通常如下:

C:\Users\Admin\AppData\Local\Programs\Python\Python311\python.exe D:/Projects/demo/main.py
Python 代码运行成功!
当前使用的解释器路径: C:\Users\Admin\AppData\Local\Programs\Python\Python311\python.exe
当前 Python 版本: 3.11.4

Process finished with exit code 0

只要最后一行是 Process finished with exit code 0,即表示代码已执行完毕且无未捕获的异常错误。

在 VS Code 中运行 Python 代码

Visual Studio Code 本质是一个代码编辑器,本身不包含 Python 语法分析与运行环境。必须通过官方扩展将解释器和调试器引入编辑器中。

1. 基础环境准备:安装扩展

在 VS Code 中运行 Python 代码前,必须完成两项准备:

  • 点击左侧活动栏的积木图标(Extensions,快捷键 Ctrl+Shift+X)。
  • 搜索 Python,安装由 Microsoft 官方发布的扩展组件(通常会一并安装 Pylance 和 Python Debugger)。

2. 选择工作区 Python 解释器

打开存放 main.py 的整个文件夹(File → Open Folder,不要单开孤立文件),然后绑定解释器:

  • 按快捷键 Ctrl+Shift+P(macOS 为 Cmd+Shift+P)调出命令面板。
  • 输入 Python: Select Interpreter 并回车。
  • VS Code 会自动扫描系统环境变量中已安装的 Python 和当前目录下的虚拟环境。点击列表中需要的环境即可。
  • 绑定成功后,右下角状态栏会常驻显示当前解释器的版本号与虚拟环境名称(例如 3.11.4 ('venv': venv))。

3. 三种常见的运行方式

  • 右上角播放按钮(推荐):打开 main.py,在编辑器右上角能看到一个实心三角播放图标。直接点击它,或者点击三角旁边的下拉箭头选择 Run Python File。VS Code 会在下方启动一个集成终端,并自动输入解释器路径及当前脚本的绝对路径来执行。
  • 右键菜单执行:在编辑区域右键,选择 Run Python → Run Python File in Terminal。
  • Shift + Enter 逐行交互运行:鼠标光标停留在一行代码上,或高亮选中多行代码,按下 Shift+Enter。VS Code 会启动交互式 Python 终端(REPL),立即输出执行结果。这种方式适合探索性数据清洗或算法验证。
PyCharm和VS Code中怎么运行Python代码
图3:VS Code中从扩展安装、环境绑定到集成终端输出的执行路径

核心机制对比:PyCharm 与 VS Code 的运行差异

两个工具虽然最终都调用系统的 python 命令,但二者的环境管理模型和执行载体完全不同:

对比维度 PyCharm VS Code
环境绑定层级 项目级别(Project Level)。设置跟随 .idea 目录,换文件默认沿用当前项目解释器。 工作区级别(Workspace Level)。通过 .vscode/settings.json 中的配置项绑定。
运行载体 内部独立的“Run”窗口。并非全功能 Shell,专为展示程序输出与退出码设计。 内置系统终端(Integrated Terminal)。直接调用系统的 PowerShell、cmd 或 Bash。
单次执行配置 自动生成并保存独立的 Run/Debug Configuration,可单独配置工作目录和启动参数。 通常直接基于文件运行,复杂启动参数需要配置 launch.json 文件。
未安装环境时的表现 直接弹窗提示“No Python interpreter configured”,强制要求指定路径后才能执行。 未装插件时当做纯文本打开;装了插件但没装 Python 会引导去官网或商城下载。

常见运行失败原因与排查方法

在实际操作中,不能正常输出预期结果的情况往往不是代码本身有语法错误,而是调用链条脱节。以下是三种最典型的问题排查方式:

1. 终端提示“ModuleNotFoundError: No module named 'xxx'”

原因:运行脚本所使用的解释器,与你在系统命令行中使用 pip install xxx 安装第三方库的解释器不是同一个。

排查:检查运行界面第一行输出的 Python 执行路径。例如,若终端打印的是全局安装路径 C:\Python311\python.exe,而你的包安装在项目的虚拟环境 .venv/Scripts/python.exe 中,程序就无法引用该包。在 PyCharm 中检查 Settings → Python Interpreter 列表是否包含该库;在 VS Code 中通过 Select Interpreter 切换到安装了依赖的具体虚拟环境。

2. VS Code 中找不到右上角运行按钮

原因:文件未被正确识别为 Python 脚本,或者核心扩展未启用。

排查:观察右下角语言模式是否显示为 Python。如果显示为 Plain Text,手动点击并切换为 Python;如果依然没有按钮,在左侧扩展面板检查 Python 扩展是否处于“Disabled”状态,必要时重新加载窗口(Developer: Reload Window)。

3. 相对路径读取文件报错“FileNotFoundError”

在代码中打开同目录下的数据文件时(例如 open("data.txt")),有时会提示找不到文件。这是因为两个工具默认的工作目录(Working Directory)判定规则不同:

  • PyCharm 默认将运行配置中的工作目录设置为当前项目根目录。
  • VS Code 默认将工作目录设定为你在左侧资源管理器打开的文件目录(即 Workspace Folder)。如果直接使用“Open File”打开单个文件,工作目录可能漂移到系统主目录。
防错建议:处理文件路径时,优先使用 os.path.dirname(os.path.abspath(__file__)) 或 pathlib.Path(__file__).parent 来锚定当前脚本所在目录,避免因不同工具或不同启动路径引发工作目录偏差。
PyCharm和VS Code中怎么运行Python代码
图4:运行异常常见诱因与排查路径对照

总结

在 PyCharm 与 VS Code 中运行 Python 代码,形式上是“点击绿色三角按钮”或“右键运行”,但底层本质都是编辑器将“目标文件的完整绝对路径”传递给“所选解释器可执行文件”并发起进程调用。

日常开发时,如果更偏好开箱即用、完整的项目管理以及稳固的运行配置,可以直接使用 PyCharm;如果更追求轻量启动、灵活多样的开发语言混编以及直接操控终端,则选用配置好 Python 扩展的 VS Code。不论选择哪一个工具,只要明确当前正在使用的解释器路径和当前脚本运行的工作目录,代码运行就能保持稳定可控。

相关专题:

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

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