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

阿澈
阿澈
发布时间:2026-11-18| 6人浏览过
原创

详细讲解在Visual Studio Code与PyCharm中运行Python代码的完整操作步骤、底层执行原理、常见认知辨析与错误排查指南。

在VS Code或PyCharm中运行Python代码,核心逻辑完全一致:先确认系统已安装Python解释器,再让编辑器绑定该解释器,最后通过图形按钮或快捷键触发执行。本文按准备工作、具体操作、容易混淆的认知辨析以及运行机制总结,逐步讲解在两款主流工具中运行代码的标准流程与排错方法。

准备工作:验证Python环境与示例脚本

无论选用哪款工具,代码能否运行都取决于操作系统中是否存在可用的Python解释器。编辑器本身不附带执行Python语法的功能,它们的作用是提供编写界面,并将写好的文件传递给解释器运行。

在开始配置前,请打开系统自带的终端(Windows上的CMD或PowerShell,macOS与Linux上的Terminal),输入以下命令检查Python安装状态:

python --version

部分Linux与macOS系统可能需要输入 python3 --version。若返回如 Python 3.11.4 等版本号,说明基础运行环境就绪。若提示“命令未找到”或打开应用商店,则需先前往Python官方网站下载并安装对应系统的安装包。在Windows安装时,请勾选“Add python.exe to PATH”。

接下来,建立一个实验专用的工作目录(例如 learn_python),并在其中新建文本文件 main.py,写入以下基础代码作为后续测试:

# main.py
import sys

def main():
    message = "Hello, Python Environment!"
    print(message)
    print("当前使用的Python解释器路径:", sys.executable)

if __name__ == "__main__":
    main()
在VS Code和PyCharm中怎么运行Python代码
图 1:从系统解释器到编辑器运行 Python 脚本的四个基础阶段

在 VS Code 中运行 Python 代码的步骤

Visual Studio Code 是轻量级代码编辑器。首次使用时,需要补充安装扩展并手动指派 Python 解释器。

1. 安装官方 Python 扩展

启动 VS Code,点击左侧活动栏的“扩展”(Extensions)图标(快捷键 Ctrl+Shift+X 或 macOS 上的 Cmd+Shift+X)。在搜索框中输入 Python,找到发布者标识为 Microsoft 的官方扩展并点击“Install”。该扩展提供了代码高亮、调试器支持以及编辑器右上角的运行按钮。

2. 打开项目目录并选择解释器

点击顶部菜单的“文件” > “打开文件夹”(Open Folder),选择前面建立的 learn_python 目录。随后在左侧资源管理器中点击打开 main.py。

此时需要为该工作区指定 Python 解释器。按下快捷键 Ctrl+Shift+P(macOS 为 Cmd+Shift+P)调出命令面板,输入并选择:

Python: Select Interpreter

列表中会列出系统自动检索到的所有 Python 环境(包括全局安装路径、Conda 环境或虚拟环境)。点击选用刚才安装的 Python 版本。选择完成后,VS Code 右下角的状态栏会常驻显示当前环境名称与版本号。

3. 运行代码的常见方式

在 VS Code 中有三种常用运行手段:

  • 点击右上角运行按钮:打开 main.py 页面,右上角会出现一个三角形的“Play”图标。点击该图标(或下拉菜单中的“Run Python File”),VS Code 会自动在下方拉起集成终端并执行该文件。
  • 右键菜单执行:在编辑区域的代码任意位置点击鼠标右键,在上下文菜单中选择“在终端中运行 Python 文件”(Run Python File in Terminal)。
  • 直接使用集成终端:按 Ctrl+` 打开集成终端,手动键入 python main.py 并回车。

注意:如果点击运行后终端提示 activate.ps1 无法加载,因为在此系统上禁止运行脚本,这是 Windows 默认的 PowerShell 执行策略限制。可通过在管理员终端中运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 解决,或者在 VS Code 终端下拉菜单中将默认终端切换为 Command Prompt (CMD)。

在 PyCharm 中运行 Python 代码的步骤

PyCharm 是专为 Python 开发设计的集成开发环境(IDE)。它对项目结构和虚拟环境有较严密的管理规范。

1. 打开工程与确认解释器配置

打开 PyCharm,在欢迎界面点击“Open”(若已打开其他工程,点击顶部菜单“File” > “Open”),选中 learn_python 目录并确定。

若首次打开该目录,PyCharm 通常会在右下角提示未配置解释器。此时点击顶部菜单“File” > “Settings”(macOS 为 “PyCharm” > “Preferences”),进入设置面板,导航至:

Project: learn_python > Python Interpreter

点击右上角齿轮或“Add Interpreter”按钮:

  • 若希望每个工程依赖独立,选择“Add Local Interpreter” > “Virtualenv Environment”并点击“OK”,PyCharm 会在项目内自动生成一个专用的虚拟环境。
  • 若想共用全局 Python,选择“System Interpreter”,在路径栏选中本地安装的 python.exe(或 macOS/Linux 下的 python3 可执行文件路径)。

2. 运行脚本的具体操作

解释器就绪后,在左侧“Project”目录树中双击打开 main.py。初次运行该文件时,顶部工具栏的绿色运行按钮往往处于置灰或未选中状态,可以通过以下方式激活:

  • 行号旁的绿色小箭头:在 main.py 中,如果存在 if __name__ == "__main__": 语句,左侧行号旁会出现一个绿色的向右三角图标。直接左键点击该图标,选择“Run 'main'”。
  • 右键空白处直接运行:在代码编辑区任意空白处单机右键,选择带有绿色播放图标的“Run 'main'”(快捷键为 Ctrl+Shift+F10,macOS 为 Ctrl+Shift+R)。

首次右键运行后,PyCharm 会自动在右上角保存名为 main 的“运行/调试配置”(Run/Debug Configurations)。此后每次修改代码后,直接按顶部的绿色三角按钮(或按 Shift+F10)即可重复执行。下方会弹出“Run”控制台,显示打印结果与退出代码(Process finished with exit code 0)。

在VS Code和PyCharm中怎么运行Python代码
图 2:VS Code 与 PyCharm 内部执行与解释器绑定路径对比

容易混淆的运行认知与场景辨析

在实际操作中,读者常常会遇到一些看似合理但容易引发错误的认知。对这些概念进行界定,有助于解决运行失败时的困惑。

认知一:“装了VS Code或PyCharm,就能直接执行Python”

为什么看似合理:这两款软件在介绍中都被称为“优秀的Python开发工具”,初学者容易直觉地认为安装包已经内置了Python语言本身。
实际情况:编辑器和IDE只提供语法高亮、代码提示、文件管理和操作界面。它们负责把代码文件与指令组织好,然后交给计算机上的 python.exe 去实际执行。如果操作系统里从未安装过 Python,无论怎么点击运行按钮,软件都只能报出“No interpreter configured”或找不到可执行文件的错误。

认知二:“终端输入pip装了库,编辑器运行却提示ModuleNotFoundError”

为什么看似合理:读者通过系统终端运行了 pip install pandas,终端提示安装成功,逻辑上计算机里已经有了这个库。
问题根源:系统环境与项目环境不匹配。如果系统全局安装了一个 Python,而 PyCharm 或 VS Code 中项目绑定的是一个独立的虚拟环境(Virtualenv 或 Conda),两者属于完全隔离的文件夹。在系统终端执行的 pip 只是把包存到了全局目录中,并没有安装进项目当前选用的虚拟环境。
正确操作:检查代码输出中的 sys.executable。如果需要安装依赖,应当在 VS Code 或 PyCharm 已经激活对应虚拟环境的内置终端中执行 pip install,或者通过 PyCharm 设置中的解释器包列表进行图形化安装。

认知三:“点击右上角的绿三角,每次运行的一定是当前正在编辑的文件”

在 VS Code 中:右上角的三角形默认会抓取当前获得焦点的活动编辑窗口(Active File),确实多为当前文件。
在 PyCharm 中:这是一种常见误解。PyCharm 顶部的绿色运行按钮是与右上角的“当前运行配置”下拉框绑定的。例如,如果之前右键运行过 test.py,哪怕当前切换到了 main.py 的代码标签页,直接点右上角的绿色三角,依然会继续执行 test.py。要运行新文件,必须在编辑区内通过右键重新选择“Run 'main'”,或者使用快捷键 Ctrl+Shift+F10。

在VS Code和PyCharm中怎么运行Python代码
图 3:VS Code 与 PyCharm 运行行为与定位关键差异对比

常见运行异常排查

当点击运行没有任何输出或终端直接标红时,通常集中在以下两类问题:

1. 路径与工作目录(Working Directory)不一致

在读取本地相对路径文件(如 open("data.txt"))时,常抛出 FileNotFoundError。这是因为程序的“当前工作目录”并不是当前代码文件所在的目录,而是编辑器启动终端时的根路径。

  • 在 VS Code 中,默认工作目录为当前打开的根文件夹。若脚本位于子文件夹中,直接读取子文件同级数据可能失败。可打开设置,搜索并勾选 python.terminal.executeInFileDir,使终端在执行时自动切换到脚本所在子目录。
  • 在 PyCharm 中,点击顶部运行配置下拉框 > “Edit Configurations”,检查其中的“Working directory”字段,将其设置为所需数据所在的绝对路径。

2. 解释器未指定或环境损坏

在 VS Code 状态栏若显示“Select Interpreter”,说明未选择解析器;若选择后仍无响应,按 Ctrl+Shift+P 运行 Developer: Reload Window 重新加载窗口。在 PyCharm 中,若控制台提示解释器无响应,前往“Settings” > “Python Interpreter”中查看列表,标红的环境说明原文件路径已被删除或移动,需点击右侧重新选择有效路径。

总结与操作决策建议

在两款工具中运行代码,最终本质都是操作系统拉起 python [选项] 脚本路径 的进程调用。选择何种运行方式,可以根据手头的工作目标做出判断:

  • 如果是快速测试单段逻辑、分析离散脚本或处理多语言混编项目,推荐使用 VS Code,通过状态栏切换解释器,直接利用右上角按钮在集成终端中观察输出。
  • 如果是结构完整的 Python 项目、包含多个子模块互相调用并依赖严格的虚拟环境,推荐使用 PyCharm,通过严谨的“运行配置”和行号运行箭头,可以更精准地控制执行参数、环境变量与工作目录。
在VS Code和PyCharm中怎么运行Python代码
图 4:运行 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 算法库。