VS Code和PyCharm中运行Python脚本的操作指南

咖啡半糖

发布时间：2026-11-06 | 7人浏览过

原创

系统介绍在Visual Studio Code与PyCharm中运行Python脚本的完整实操步骤，涵盖解释器选择与绑定、快速运行与带参运行、工作目录与调试机制，以及ModuleNotFoundError等常见报错的排查排错指南。

在编写 Python 脚本后，让代码顺利运行的核心前提是让开发工具正确定位并绑定对应的 Python 解释器。Visual Studio Code 依托轻量架构与插件机制，通过集成终端完成命令派发；PyCharm 作为专业的集成开发环境，则采用项目级的配置模型与独立进程托管机制。本文按环境准备、解释器绑定、单文件运行、带参调试以及常见报错排查的完整链条，详细讲解两款工具中运行 Python 脚本的具体操作。

VS Code和PyCharm中运行Python脚本的操作指南 — 图 0：VS Code 与 PyCharm 运行 Python 脚本的核心机制与界面交互概览

一、理解“运行 Python 脚本”的底层逻辑

无论是点击编辑器界面上的绿色三角按钮，还是按下键盘快捷键，集成开发环境（IDE）本质上都在执行同一套底层操作：启动一个终端子进程，调用指定的 Python 可执行程序（python 或 python.exe），并将目标脚本的完整路径作为参数传递给它。

因此，代码能否运行、调用的第三方库是否完备，完全取决于两点：一是 IDE 当前绑定的是哪一个 Python 解释器（是全局系统环境、Conda 环境，还是项目专属的虚拟环境 .venv）；二是脚本启动时的“工作目录”（Working Directory）位于何处。清晰理解这一逻辑后，面对不同工具的操作差异便能游刃有余。

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

Visual Studio Code 是一款通用的代码编辑器，本身不包含 Python 运行环境。在 VS Code 中运行 Python 脚本，需通过官方扩展建立与 Python 运行时的连接。

1. 安装官方 Python 扩展

在 VS Code 界面左侧活动栏点击“扩展”图标（或按下快捷键 Ctrl+Shift+X / macOS 下为 Cmd+Shift+X），在搜索框中键入 Python，找到由 Microsoft 官方发布的扩展并点击“安装”（Install）。该扩展为编辑器注入语法解析、调试适配器、测试运行器以及解释器切换功能。

2. 选择正确的 Python 解释器

按下快捷键 Ctrl+Shift+P（macOS 为 Cmd+Shift+P）调出顶部命令面板，输入并选择：

Python: Select Interpreter

此时下拉列表中会展示系统自动检测到的所有 Python 环境：

工作区虚拟环境：通常显示为 .venv: venv 或 env: venv，这是工程开发中最推荐的选项。
Conda 环境：列出本地安装的 Anaconda 或 Miniconda 虚拟环境名称。
全局系统环境：操作系统自带或全局安装的 Python 解释器路径。

点击对应项完成绑定后，可查看 VS Code 右下角状态栏。如果显示出类似 3.11.5 ('.venv': venv) 的字样，表明解释器已成功绑定。

3. 运行脚本的具体操作方式

在编辑器中打开准备运行的 .py 脚本（例如 main.py），可以通过以下三种常用方式触发执行：

方式 A：右上角运行按钮：在编辑器窗口右上角，点击绿色的三角形按钮（鼠标悬停提示为“Run Python File”）。VS Code 会自动在下方拉起集成终端，激活对应虚拟环境并执行该文件。
方式 B：编辑区右键菜单：在代码编辑区域任意空白处点击鼠标右键，在右键上下文菜单中选择“Run Python” -> “Run Python File in Terminal”。
方式 C：直接在集成终端中执行：按下 Ctrl+`（反引号）打开终端，确认终端提示符前带有环境名称前缀（如 (.venv)），随后手动输入运行命令：

# 在项目根目录下执行
python main.py

注意：如果脚本需要接收命令行参数（如 python main.py --mode train --epochs 10），直接点击右上角三角按钮无法传参。此时应当在集成终端中直接附加参数运行，或通过创建 .vscode/launch.json 配置文件进行调试运行。

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

PyCharm 专注于 Python 开发，具备高度结构化的项目模型与运行配置管理体系。运行 Python 脚本通常与特定的“运行/调试配置”（Run/Debug Configurations）相绑定。

1. 检查与配置项目解释器

在运行代码之前，应确认项目已关联有效的 Python 解释器：

Windows / Linux：点击顶部菜单栏 File -> Settings（快捷键 Ctrl+Alt+S）。
macOS：点击 PyCharm -> Settings 或 Preferences（快捷键 Cmd+,）。

在设置面板左侧展开 Project: <项目名>，点击 Python Interpreter。若右侧显示为空，点击“Add Interpreter” -> “Add Local Interpreter”，可选择创建全新的 Virtualenv 环境或选择本地现有的 python.exe。

2. 运行脚本的快捷入口

在 PyCharm 中，有三个直观的入口可以立即执行当前文件：

入口一：行号槽快捷运行：在包含 if __name__ == '__main__': 的主入口行，左侧行号边缘会出现一个绿色的小三角图标，直接左键点击该图标，选择“Run 'main'”。
入口二：编辑器右键执行：在编辑区域内右键单击，选择“Run '文件名'”（快捷键为 Shift+F10，macOS 为 Ctrl+R）。
入口三：顶部工具栏运行控制区：PyCharm 会自动将最近运行过的文件保存为顶部工具栏的下拉项，点击下拉框右侧的绿色播放三角即可重复执行。

3. 配置运行参数与工作目录（Edit Configurations）

PyCharm 的显著优势在于图形化的配置管理器。点击顶部运行栏下拉菜单中的 Edit Configurations...，会弹出详细的配置面板：

Script path：待执行的 Python 入口文件路径。
Parameters：需要传递给脚本的命令行实参。例如填入 --input data.csv --verbose，程序中 sys.argv 即可直接读取。
Working directory：指定脚本执行时的工作目录。当项目存在多层嵌套目录且涉及相对路径文件读取时，修改此处可确保路径解析基准一致。
Environment variables：设置自定义环境变量（如 DEBUG=True、API_KEY=xxx），无需污染全局操作系统环境。

执行结果观察：点击运行后，PyCharm 会自动在窗口底部激活“Run”控制台。控制台第一行会打印出调用的完整 Python 命令及所选解释器，末尾输出 Process finished with exit code 0 即代表脚本正常运行完毕。

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

尽管两款工具都能顺利执行 Python 脚本，但它们在环境隔离、参数持久化和底层调用链条上有着本质的设计理念差异。

对比维度	Visual Studio Code	JetBrains PyCharm
执行载体	依赖内置的操作系统终端（bash、zsh 或 PowerShell）派发命令	由 IDE 底层直接拉起独立的托管子进程，输出流重定向至图形控制台
参数传递方式	直接在终端中手动追加，或配置 `.vscode/launch.json` 中的 `args` 字段	通过“Edit Configurations”界面的 Parameters 输入框直接填写并自动持久化
多运行配置管理	需在 `launch.json` 中手工编写 JSON 对象结构	图形化界面支持任意克隆、重命名和并行管理多套运行预设
工作目录基准	默认锁定在当前打开的工作区根目录（Workspace Root）	默认采用脚本所在目录或工程根目录，可在配置中针对单脚本精确重设
环境感知机制	通过插件分析文件路径和 Shell 变量，轻量非侵入	建立全项目 AST 语法索引（Indexing），强绑定 SDK 依赖树

五、常见运行故障排查与解决方法

在日常运行 Python 脚本的过程中，开发者最常遇到的是模块找不到、路径解析错误以及解释器冲突等问题。按照以下路径可快速定位并修复。

1. ModuleNotFoundError: No module named 'xxx'

这是最常见的报错。其根本原因在于：在系统终端中用 pip install 安装包的 Python 环境，与 IDE 运行时所指定的 Python 解释器不是同一个。

排查方法：在代码首行加入打印语句：
```
import sys
print(sys.executable)
```
修复方法：查看打印出的 Python 路径。若要在该环境中安装缺失的模块，切勿直接在外部运行裸命令 pip，而应在 IDE 内部终端中使用该解释器显式安装：
```
python -m pip install 模块名
```
使用 python -m pip 可以 100% 确保依赖安装到当前调用的 Python 解释器目录下。

2. FileNotFoundError: [Errno 2] No such file or directory

当代码中使用相对路径打开文件（如 open("data/config.json")）时常出现此错误。相对路径的查找起点是“当前进程的工作目录（Current Working Directory, CWD）”，而不是脚本文件所在的物理目录。

在 PyCharm 中：打开 Edit Configurations，将 Working directory 调整为目标文件所在的父目录。

在 VS Code 中：若终端运行路径与文件位置不一致，可在代码中改用基于脚本文件绝对路径的动态定位方案：

from pathlib import Path

# 获取当前脚本所在的绝对目录，再拼接目标文件
BASE_DIR = Path(__file__).resolve().parent
file_path = BASE_DIR / "data" / "config.json"
with open(file_path, "r", encoding="utf-8") as f:
    content = f.read()

3. VS Code 提示“Select a Python Interpreter”

若右下角提示未选择解释器，说明 VS Code 无法在当前系统路径下自动扫描到有效安装。请按下 Ctrl+Shift+P -> Python: Select Interpreter -> Enter interpreter path...，手动浏览并定位到系统安装目录下的 python.exe（Windows）或 /usr/local/bin/python3（macOS/Linux）。

避坑提示：在 Windows 系统下如果通过 Microsoft Store 安装了 Python，有时会在终端中留下无权限的空占位程序 python.exe。若遇到调用后无响应或直接打开应用商店的情况，请前往系统“管理应用执行别名”设置中，关闭“应用安装程序 Python”的开关，并重新使用官网安装包配置环境变量。

六、总结与日常开发建议

运行 Python 脚本不是单一维度的工具点击，而是建立在解释器绑定、运行环境隔离与工作目录控制之上的工程实践。

对于日常开发而言，如果主要进行短平快的单个脚本调试、临时数据分析处理，或者参与混合语言工程，VS Code 启动敏捷、轻量灵活，配合集成终端能够提供与生产服务器高度一致的操作体感；如果开发面向对象复杂的后端工程（如 Django、FastAPI）、算法框架或需要持久化管理多组不同的命令行运行参数，PyCharm 的运行配置中心与深度调试工具将带来更稳健的开发体验。