VS Code和PyCharm中怎么直接运行py脚本

一、运行前的前提：确保脚本与解释器绑定

Python 是一门解释型语言，纯文本格式的 .py 脚本本身不具备直接执行能力，必须由系统中的 Python 解释器程序（如 python.exe 或 python3）读取并编译执行。初学者在使用现代化 IDE 时，最容易忽略的一点是：编辑界面的代码文件与后台真正执行代码的解释器是相互独立的。如果 IDE 未正确识别或绑定解释器，任何直接运行的指令都会失败或执行在错误的环境中。

1. 在 VS Code 中确认解释器

在 VS Code 中打开一个 .py 文件后，观察界面最下方的状态栏右下侧（新版本有时位于右上侧状态区），会显示当前选中的 Python 版本与环境名称（例如 Python 3.10.12 ('venv': venv)）。

• 切换方式：点击状态栏的环境标签，或者按下组合快捷键 Ctrl + Shift + P（macOS 为 Command + Shift + P）唤起命令面板，输入 Python: Select Interpreter 并回车。
• 选择原则：在弹出的解释器列表中，优先选择当前项目根目录下的虚拟环境（带有 venv、.venv 或 conda 标识的选项），确保后续运行使用的是安装了项目依赖的独立环境。

2. 在 PyCharm 中确认解释器

PyCharm 具备强工程管理属性。打开项目后，进入设置菜单查看解释器绑定状态：

• Windows / Linux 入口：依次点击顶部菜单 File ➔ Settings（或使用快捷键 Ctrl + Alt + S），在左侧导航树中展开 Project: [项目名] ➔ 点击 Python Interpreter。
• macOS 入口：点击顶部应用菜单 PyCharm ➔ Preferences（或快捷键 Command + ,），同样找到 Project: [项目名] ➔ Python Interpreter。
• 在右侧面板中，可以清晰看到当前项目绑定的 Python 可执行文件路径以及已安装的第三方库列表。如果显示 <No Interpreter>，点击 Add Interpreter 关联已有的虚拟环境或新建环境。

二、VS Code 中直接运行 Python 脚本的三种方式

在 VS Code 中，运行 Python 脚本本质上是由官方 Python 插件将执行命令投递到底部的集成终端（Integrated Terminal）。只要安装了官方推荐的 Python 插件（由 Microsoft 提供），便可以通过以下三种直观方式直接触发执行。

方式一：点击右上角运行按钮（最直观）

打开目标 .py 文件，将视线移至代码编辑窗口的右上角。你会看到一个绿色的三角形播放图标（Run Python File）：

• 直接单击该三角形图标，VS Code 会自动在界面下方调出集成终端。
• 终端会自动激活选中的虚拟环境，并输入类似 & /path/to/python /path/to/script.py 的命令自动执行。
• 下拉选项：点击三角形右侧的小箭头，可选择“在专用终端中运行 Python 文件（Run Python File in Dedicated Terminal）”，方便将输出与日常命令区分开。

方式二：代码编辑区右键菜单

如果在全屏或多窗口编码时不方便点击右上角微缩按钮，使用右键菜单是最顺手的途径：

• 在代码编辑区域的任意空白处单击鼠标右键。
• 在弹出的上下文菜单中，找到并点击 “在终端中运行 Python 文件”（Run Python File in Terminal）。
• 程序会立即在下方终端开始执行，输出日志直接打印在控制台中。

方式三：快捷键与选区交互式执行

对于习惯键盘流操作的开发者，VS Code 提供了全文件免调试运行以及代码片段交互执行能力：

• 免调试直接运行：按下 Ctrl + F5（macOS 为 Control + F5），VS Code 会以 Run Without Debugging 模式启动文件，跳过断点直接执行至结束。
• 单行或选中代码执行：使用鼠标选中想要验证的多行代码（或光标停留在某一行），按下 Shift + Enter。VS Code 会在终端中开启一个交互式 Python REPL 会话，并将选中的代码逐行发送执行。这种方式非常适合在不重跑整个大脚本的前提下快速验证某个函数或数据清洗逻辑。

三、PyCharm 中直接运行 Python 脚本的三种方式

作为专为 Python 打造的重量级集成开发环境，PyCharm 将每次执行都封装为一套完善的 运行配置（Run Configuration）。它不仅负责启动进程，还提供独立的运行控制台（Run Tool Window）、变量监听与调用栈单机穿透能力。

方式一：代码编辑区右键直接运行（初次执行最佳）

当编写完一个新的 Python 脚本文件时，最推荐的首次运行操作是：

• 在编辑器内的代码区域点击鼠标右键。
• 在菜单中找到带绿色播放图标的 Run '[文件名]'（例如脚本名为 main.py，则显示为 Run 'main'）。
• 点击后，界面下方会自动弹出专属的 Run 控制台，打印运行结果与退出码 Process finished with exit code 0。
• 与此同时，PyCharm 会自动在右上角为你保存一个以该文件名命名的临时运行配置。

方式二：行号左侧代码块（Gutter）绿色三角

PyCharm 能够智能静态分析 Python 入口点。当你的脚本中包含标准的主入口判断语句：

if __name__ == '__main__':
    print("正在直接运行 Python 脚本...")
    # 执行业务逻辑
    result = sum([1, 2, 3, 4, 5])
    print("计算结果为:", result)

在行号左侧的边栏（Gutter 区），if __name__ == '__main__': 这一行旁边会出现一个醒目的绿色小三角。直接左键点击该三角形，并在弹出菜单中选择 Run 'main'，即可瞬间启动。

方式三：顶部运行工具栏与全局快捷键

只要文件曾经被运行过一次，右上角的下拉框就会记录该文件的配置：

• 运行当前文件快捷键：在任何时候，只要光标位于当前脚本中，按下 Ctrl + Shift + F10（macOS 为 Control + Shift + R），PyCharm 会立即编译并运行当前文件。
• 重新运行上次配置：按下 Shift + F10（macOS 为 Control + R），PyCharm 会再次运行当前顶部下拉框中选中的那个脚本，无需重新寻找菜单。
• 顶部绿色小三角：直接点击 PyCharm 窗口右上角工具栏的绿色播放图标，效果等同于 Shift + F10。

四、机制差异对比与常见运行故障排查

了解两款工具在运行机制上的深层差异，有助于在遇到“终端能跑但编辑器报错”、“明明装了包却找不到”等高频问题时迅速定位原因。

故障一：ModuleNotFoundError: No module named 'xxx'

现象描述：在系统终端里执行 pip install pandas 显示已安装，但在 VS Code 或 PyCharm 里直接点击运行，却抛出模块缺失错误。

根本原因：终端执行 pip 时的环境变量与 IDE 界面当前选定的 Python 解释器不属于同一个路径。

排查与修复步骤：

1. 在你的脚本首行加入以下调试代码并直接运行：

import sys
print("当前脚本使用的 Python 解释器路径为:")
print(sys.executable)

示例输出：

当前脚本使用的 Python 解释器路径为:
/Users/developer/my_project/.venv/bin/python

2. 对比输出的路径与你安装依赖时的环境是否完全一致。
3. 在 VS Code 中，按 Ctrl + Shift + P 重新选择该 .venv 路径；在 PyCharm 中，在设置中的 Python Interpreter 切换为对应的环境。

故障二：FileNotFoundError: [Errno 2] No such file or directory

现象描述：脚本与需要读取的文件（如 config.json 或 data.csv）放在同一个文件夹内，直接运行时却报找不到文件。

根本原因：不同工具对工作目录（CWD）的判定基准不同。PyCharm 默认以脚本所在文件夹为工作目录，而 VS Code 默认以编辑器打开的最外层项目根目录为工作目录。

推荐对策：不要依赖相对路径推断，在 Python 脚本中统一使用 pathlib 库基于脚本自身位置构建绝对路径：

from pathlib import Path

# 获取当前脚本所在文件夹的绝对基准路径
BASE_DIR = Path(__file__).resolve().parent

# 基于当前目录拼接目标文件路径，跨平台且不受运行目录影响
target_file = BASE_DIR / "data.csv"

with open(target_file, "r", encoding="utf-8") as f:
    content = f.read()
    print("文件读取成功，字节长度:", len(content))

故障三：运行后无任何输出或控制台瞬间闪退

排查要点：

• 检查脚本内容：如果脚本中只定义了类、函数，或者只进行了纯变量赋值运算，而没有任何 print() 语句或日志输出，控制台执行完毕自然不会有文字回显。
• 外部控制台配置：在 PyCharm 的 Run Configuration 中，确认没有错误勾选 Emulate terminal in output console 或系统外部黑窗口。确保输出统一在 IDE 下方的标准 Run 面板呈现。

五、两款工具直接运行操作速查表

下表汇总了 VS Code 与 PyCharm 在直接运行 Python 脚本时的关键参数与日常快捷键对照，方便快速检索：

无论使用 VS Code 还是 PyCharm，直接运行 Python 脚本的本质都是通过图形界面简化终端命令的调用过程。只要养成先看解释器、再看工作目录、善用快捷键的开发习惯，就能完全规避常见的环境冲突与路径报错，高效开展代码编写与功能验证。