VS Code和PyCharm怎么运行Python代码

小岛来信
小岛来信
发布时间:2026-11-17 | 14人浏览过
原创

深入详解在VS Code与PyCharm中运行Python代码的具体步骤、底层执行逻辑、多模式运行技巧以及常见报错排查,帮助开发者高效运行与调试Python程序。

运行 Python 代码的核心逻辑非常直接:让编辑工具调用系统中安装的 Python 解释器,读取目标 .py 脚本文件并按行执行。VS Code 与 PyCharm 分属轻量级文本编辑器与专业集成开发环境(IDE),两者的运行机制、界面交互与配置逻辑存在明确差异。只要完成“指定解释器”与“触发执行命令”两个核心环节,就能顺利运行代码。

一、运行前的必要准备:确认 Python 解释器

无论是 VS Code 还是 PyCharm,本身都不自带 Python 解释器(某些捆绑环境除外)。在尝试运行代码前,必须确保操作系统中已安装 Python。

可以在系统终端(Windows 的 PowerShell 或 CMD、macOS 的 Terminal)中输入以下指令核对版本:

python --version
# 如果提示无此命令,尝试:
python3 --version

若屏幕输出类似 Python 3.10.x 或 Python 3.11.x 的版本信息,说明解释器已就绪。接着在计算机中新建一个工作文件夹,并在其中新建文件 demo.py,写入以下测试代码:

import sys

print("Hello, Python!")
print(f"当前运行使用的解释器路径: {sys.executable}")

二、VS Code 怎么运行 Python 代码

VS Code 本质是一个代码编辑器。运行 Python 代码依赖官方 Python 扩展插件 将编辑界面与系统中的 Python 解释器连接起来,并通过内置终端执行。

步骤 1:安装 Python 扩展

打开 VS Code,点击左侧活动栏的积木图标(Extensions 扩展视图,快捷键 Ctrl+Shift+X 或 macOS 下的 Cmd+Shift+X),在搜索栏输入 Python,找到由 Microsoft 发布的官方插件并点击 Install。该插件提供了代码高亮、智能补全以及运行入口支持。

步骤 2:选择 Python 解释器(关键步骤)

打开刚才创建的 demo.py 文件。VS Code 右下角状态栏通常会显示检测到的 Python 版本(例如 3.10.x 64-bit)。若没有显示或识别错误,按快捷键 Ctrl+Shift+P(macOS 为 Cmd+Shift+P)调出命令面板,输入并选择:

Python: Select Interpreter

在弹出的列表中,点击选择系统中的 Python 路径(或已创建的虚拟环境 .venv)。一旦选定,VS Code 会在项目根目录下的 .vscode/settings.json 中记住该配置。

步骤 3:触发运行代码的四种常见方式

  1. 右上角运行三角按钮:打开 .py 文件后,编辑器窗口右上角会出现一个绿色的播放三角形图标。点击该按钮(或点击下拉菜单选择 Run Python File in Terminal),VS Code 会自动拉起底部集成终端,输入解释器完整路径并执行当前脚本。
  2. 右键菜单执行:在编辑区域任意空白处单击鼠标右键,在弹出菜单中选择 Run Python > Run Python File in Terminal(在终端中运行 Python 文件)。
  3. 快捷键无调试运行与调试运行:按 Ctrl+F5(macOS 为 Ctrl+F5)可直接启动运行;按 F5 会进入调试模式(Debug),可在代码行左侧打断点逐行跟踪变量。
  4. 交互式运行片段(REPL / Shift+Enter):用鼠标框选中某几行代码,按下 Shift+Enter,选中的代码会被发送到 Python 交互终端单独执行,无需从头运行整个文件。
VS Code和PyCharm怎么运行Python代码
图 1:VS Code 运行 Python 代码的步骤分解与终端交互过程

三、PyCharm 怎么运行 Python 代码

PyCharm 作为 JetBrains 旗下的专业 Python IDE,管理代码是以项目(Project)为单位的。它具备严密的运行配置(Run Configurations)系统,代码执行时由独立的子进程承载,而不是简单地向普通终端贴命令行。

步骤 1:设置项目解释器(Project Interpreter)

首次用 PyCharm 打开包含代码的文件夹或创建新项目时,PyCharm 会尝试自动检测或创建虚拟环境。如果需要手动核实或更改:

  • Windows:点击顶部菜单栏 File > Settings(快捷键 Ctrl+Alt+S)。
  • macOS:点击顶部菜单栏 PyCharm > Settings(快捷键 Cmd+,)。
  • 在左侧导航栏展开 Project: [项目名] > Python Interpreter。
  • 在右侧下拉菜单查看当前绑定的解释器。若为空,点击 Add Interpreter > Add Local Interpreter...,选择现有的 Python 解释器或新建 Virtualenv。

步骤 2:首次运行:右键启动生成配置

初学者使用 PyCharm 最容易遇到的困惑是“顶部的绿色运行按钮是灰色的,点不了”。这是因为 PyCharm 还没有为当前文件建立运行配置。

正确的启动步骤为:

  1. 在项目目录树或代码编辑窗口内,找到要运行的 demo.py。
  2. 在代码编辑区域的任意位置单击鼠标右键。
  3. 在右键菜单中找到带有绿色小三角形的选项:Run 'demo'(快捷键为 Ctrl+Shift+F10,macOS 为 Ctrl+Shift+R)。
  4. 点击后,底部会自动弹出 Run 工具窗口,程序开始执行并打印输出结果。

完成首次右键运行后,PyCharm 顶部工具栏的下拉菜单中会自动保存名为 demo 的运行配置。此时顶部的绿色运行三角形与绿色调试甲虫(Debug)就会亮起激活,之后直接点击工具栏按钮或按 Shift+F10 即可重复运行该文件。

步骤 3:代码行号侧边栏(Gutter)直接运行

如果代码中包含 if __name__ == '__main__': 入口,该行左侧的行号区(Gutter)会出现一个绿色双三角图标,直接左键点击该图标,同样会弹出 Run 'demo' 或 Debug 'demo' 选项,操作非常直观。

VS Code和PyCharm怎么运行Python代码
图 2:PyCharm 运行配置的生成机制与控制台生命周期控制

四、VS Code 与 PyCharm 运行机制深度对比

很多开发者在两者之间切换时,会发现操作习惯有很大不同。下表清晰列出了两者的核心差异:

对比维度 Visual Studio Code PyCharm (Community / Professional)
定位与形态 通用代码编辑器 + Python 扩展 针对 Python 深度优化的专有 IDE
运行承载介质 系统命令行终端(PowerShell / Zsh / Bash) 专用 Run 控制台工具窗口(进程托管)
解释器切换粒度 工作区级别,状态栏随时切换单个解释器 项目绑定,强关联虚拟环境与安装包目录
常用运行触发入口 右上角运行三角、右键终端运行、Shift+Enter 右键生成 Run 配置、顶部工具栏、Gutter 箭头
启动参数与工作目录 需在 .vscode/launch.json 中手工编写 JSON 在 Edit Configurations 弹窗中可视化表单填写
内存占用与启动速度 启动迅速,资源占用小,随开随写 需建立项目索引,较占内存,但索引完成后功能极其强大
VS Code和PyCharm怎么运行Python代码
图 3:VS Code 终端驱动与 PyCharm 配置驱动的设计差异对比

五、常见运行失败原因与排查步骤

很多初学者在运行 Python 代码时遇到报错,误以为是编辑器损坏或代码写错,实际上绝大多数故障源于“环境配置脱节”。以下是最常见的三类问题及对应解决方案:

1. 提示 “'python' 不是内部或外部命令”或找不到解释器

原因:系统 PATH 环境变量中未包含 Python 的安装目录,或者编辑器未指定解释器。

解决办法:

  • 在 VS Code 中,按 Ctrl+Shift+P 重新执行 Python: Select Interpreter,点击 Enter interpreter path... 手动浏览找到系统中的 python.exe(Windows)或 python3(macOS/Linux)路径。
  • 在 PyCharm 中,进入 Settings > Project > Python Interpreter,重新添加 Local Interpreter。

2. 提示 “ModuleNotFoundError: No module named 'xxx'”

原因:安装第三方库的 Python 环境与编辑器当前运行脚本的 Python 环境不一致。例如在系统终端执行了 pip install requests(装在全局 Python),而编辑器正在使用虚拟环境 .venv(里面没有装 requests)。

解决办法:

  • 在 VS Code 中:使用 VS Code 顶部菜单的 Terminal > New Terminal 打开内置终端,确认命令行开头是否有 (.venv) 标识。在该终端直接执行 pip install [包名],确保装入当前环境。
  • 在 PyCharm 中:点击底部 Python Packages 标签,搜索需要的包点击 Install;或者直接在 PyCharm 内置的 Terminal 中执行 pip install [包名]。

3. PyCharm 运行按钮置灰,或点击运行执行了旧文件

原因:工具栏顶部的下拉框仍停留在之前运行的文件名上,未随当前正在编辑的文件自动切换;或当前文件未生成运行配置。

解决办法:永远使用 在当前编辑窗口中点击鼠标右键 > Run '当前文件名'。右键执行能强制刷新当前运行上下文,并自动更新顶部工具栏的选中目标。

VS Code和PyCharm怎么运行Python代码
图 4:Python 代码运行失败时的三大主因与针对性处置流程

六、总结与使用建议

掌握在 VS Code 和 PyCharm 中运行 Python 代码的方法后,可以根据工作内容合理选用工具:

  • 轻量编辑与学习探索推荐 VS Code:如果平时写单独的自动化脚本、进行快速数据清洗、或者需要在一个窗口内同时开发前端和 Python 代码,VS Code 凭借极其轻巧的启动速度和灵活的插件生态能提供更顺畅的体验。日常运行直接使用右上角播放图标或 Shift+Enter 逐段交互。
  • 工程化研发与团队协作推荐 PyCharm:如果是开发基于 Django、FastAPI、Flask 的完整项目,或者项目文件繁多、依赖复杂虚拟环境,PyCharm 的运行配置体系、代码静态检查和调试能力会显著提高开发效率。日常运行养成“首次右键启动、后续 Shift+F10 快速重跑”的习惯即可。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表