VS Code和PyCharm中运行Python脚本的操作步骤

在日常Python开发中，VS Code与PyCharm是应用最为广泛的两款集成开发环境与编辑器。运行Python脚本的核心逻辑一致：调用计算机中指定的Python解释器执行目标文件并将结果输出至终端或控制台。但两者在界面交互、配置流程及环境管理上存在差异。本文将按照实际操作顺序，分别梳理在VS Code和PyCharm中准备环境、选择解释器、触发脚本运行的具体步骤，并说明常见执行异常的排查方法。

一、准备工作：创建测试脚本

为了直观验证脚本是否正常运行，首先需要在计算机上准备一个基础的 Python 脚本。打开任意文本编辑器或直接在项目中新建文件 demo.py，输入以下测试代码：

import sys
import os

def main():
    print("Python 脚本执行成功！")
    print(f"当前运行解释器: {sys.executable}")
    print(f"当前工作目录: {os.getcwd()}")

if __name__ == "__main__":
    main()

该脚本不仅会输出提示文本，还会打印出当前实际调用的 Python 解释器路径以及工作目录，这对后续核对环境是否匹配非常关键。

二、VS Code 中运行 Python 脚本的操作步骤

VS Code 是一款轻量级代码编辑器，其 Python 开发能力由官方扩展提供支持。脚本默认直接调度系统终端（Terminal）执行。

步骤 1：安装 Python 官方扩展

1. 启动 VS Code，点击左侧活动栏的“扩展”（Extensions）图标，或直接按下快捷键 Ctrl+Shift+X（macOS 为 Cmd+Shift+X）。
2. 在顶部搜索框输入 Python，找到由 Microsoft 官方发布的扩展并点击 Install（安装）。
3. 安装完成后无需重启，该扩展将提供解释器检测、语法高亮与运行支持。

步骤 2：选择 Python 解释器

运行脚本前，必须为当前工作区指定由哪个 Python 解释器负责编译运行：

1. 按下快捷键 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）调出全局命令面板。
2. 在输入框输入 Python: Select Interpreter 并按回车。
3. 系统会扫描列出本机检测到的所有 Python 环境（包括全局安装路径、conda 环境及已创建的虚拟环境 .venv）。选择目标解释器版本即可。
4. 设置成功后，VS Code 窗口右下角状态栏会常驻显示当前所选解释器版本号（如 3.10.12 ('venv': venv)）。

步骤 3：触发运行的常用方式

在编辑器中打开 demo.py 文件，可以通过以下三种方式启动运行：

• 方式 A（右上角运行按钮）： 查看代码编辑器右上角，点击绿色的三角形播放图标（▷），在下拉菜单中选择 Run Python File。
• 方式 B（右键上下文菜单）： 在代码编辑区的任意空白位置右键点击，在弹出的右键菜单中选择 在终端中运行 Python 文件（Run Python File in Terminal）。
• 方式 C（集成终端直接执行）： 按下快捷键 Ctrl+`（反引号）调出下方集成终端，终端会自动激活所选虚拟环境，在终端直接输入以下命令并回车：

python demo.py

步骤 4：查看运行输出

触发运行后，VS Code 下方会自动切换到“终端”（Terminal）标签页，显示完整的调用命令与执行结果。例如：

PS D:\projects\demo> & "D:/projects/demo/.venv/Scripts/python.exe" "d:/projects/demo/demo.py"
Python 脚本执行成功！
当前运行解释器: D:\projects\demo\.venv\Scripts\python.exe
当前工作目录: D:\projects\demo

三、PyCharm 中运行 Python 脚本的操作步骤

PyCharm 是专为 Python 设计的重量级集成开发环境，具备开箱即用的解释器绑定与项目运行配置（Run/Debug Configuration）机制。

步骤 1：确认项目解释器（Project Interpreter）

1. 打开 PyCharm 并加载项目目录。
2. 进入设置菜单：
   • Windows / Linux：点击菜单栏 File -> Settings（快捷键 Ctrl+Alt+S）。
   • macOS：点击菜单栏 PyCharm -> Settings / Preferences（快捷键 Cmd+,）。
3. 在左侧导航栏展开 Project: [项目名称]，点击 Python Interpreter。
4. 观察顶部解释器下拉框。若显示为空或需要切换，点击右侧的 Add Interpreter -> Add Local Interpreter，选择新建 Virtualenv 虚拟环境或绑定现有的 Python 可执行文件。
5. 点击右下角 Apply 与 OK 保存。

步骤 2：触发运行的具体方式

PyCharm 为每个脚本的执行提供了独立的运行控制台，主要有以下三种启动路径：

• 方式 A（代码行号旁的绿色小三角）： 如果脚本中包含 if __name__ == '__main__':，在该行左侧的代码行号旁会出现一个绿色的三角形图标。左键点击它，选择 Run 'demo'。
• 方式 B（编辑器内右键快捷运行）： 在代码编辑区任意空白处点击鼠标右键，在菜单中选择 Run 'demo'（也可直接按下快捷键 Ctrl+Shift+F10，macOS 为 Ctrl+Shift+R）。
• 方式 C（顶部工具栏运行按钮）： 初次执行过该脚本后，PyCharm 会自动将其加入顶部工具栏的运行配置中。后续只需直接点击顶部工具栏的绿色三角形 ▶ 按钮（快捷键 Shift+F10，macOS 为 Ctrl+R）即可重新执行该配置。

步骤 3：在专用 Run 工具窗口查看输出

触发运行后，PyCharm 界面底部会自动弹出“Run”工具窗口，内容结构清晰明确：

D:\software\Python\Python310\python.exe D:\projects\demo\demo.py
Python 脚本执行成功！
当前运行解释器: D:\software\Python\Python310\python.exe
当前工作目录: D:\projects\demo

Process finished with exit code 0

输出首行显示了 PyCharm 拼接的完整解释器路径与脚本绝对路径，末尾显示 Process finished with exit code 0，代表程序执行顺利且退出状态码正常（0 表示无异常退出）。

四、VS Code 与 PyCharm 运行机制差异对比

虽然两款工具都能顺利执行 Python 脚本，但在底层管理逻辑和使用细节上存在明显差别：

五、常见问题与排查指南

1. 报错 ModuleNotFoundError: No module named 'xxx'

这是运行脚本时最常见的错误，表明当前脚本正在使用的 Python 解释器环境中没有安装对应的依赖包。

• 排查方法： 先在测试脚本中打印 sys.executable，核对实际运行的 Python 路径。
• VS Code 解决方式： 确认右下角选中的解释器与你在终端运行 pip install xxx 时的解释器一致；或者在 VS Code 集成终端中直接运行 python -m pip install xxx，确保包装入当前解释器。
• PyCharm 解决方式： 打开 Settings -> Project -> Python Interpreter，在已安装包列表中查看是否有该库；若无，直接点击 + 号进行在线安装。

2. 相对路径读取文件报 FileNotFoundError

当代码中使用 open("data.txt") 读取文件时，Python 是以“当前工作目录（Current Working Directory）”为基准去查找文件的，而不是脚本自身的所在目录。

• 在 VS Code 中，默认工作目录通常是打开的工程文件夹根目录。若脚本放在子目录中，直接运行可能找不到文件。建议在代码中改用绝对基准路径：

  import os
  current_dir = os.path.dirname(os.path.abspath(__file__))
  file_path = os.path.join(current_dir, "data.txt")

• 在 PyCharm 中，可以打开顶部菜单 Run -> Edit Configurations，直接在 Working directory 一栏中将工作目录修改为脚本所在目录。

3. PyCharm 误跑了上一个脚本

当在 PyCharm 中切换打开另一个 .py 标签页并直接按下 Shift+F10 时，PyCharm 默认会继续执行顶部下拉框中选中的“上次运行配置”。如果想运行当前新脚本，请使用 Ctrl+Shift+F10（macOS 为 Ctrl+Shift+R），或者右键该文件选择运行，PyCharm 将会自动创建并切换为该文件的新配置。