VS Code和PyCharm中配置并运行Python脚本的方法

码头散步
码头散步
发布时间:2026-11-16| 4人浏览过
原创

全面解析在VS Code与PyCharm中配置Python解释器并运行Python脚本的具体方法,涵盖工作区绑定、调试参数设置、模块导入机制及常见路径报错排查。

在本地运行 Python 脚本的核心前提是完成宿主环境与 Python 解释器(Interpreter)的绑定。无论是轻量可扩展的代码编辑器 VS Code,还是功能高度集成的专业 IDE PyCharm,执行脚本的底层机制皆为指定合法的 Python 可执行文件路径并调用进程。本文系统讲解两款工具在解释器检测、工作目录识别、运行配置与故障排查方面的标准操作路径。

一、Python脚本运行的底层执行模型

很多开发者在初学时常误以为编辑器本身具备运行代码的能力。实际上,VS Code 与 PyCharm 仅作为开发前端与进程调度器存在,真实的编译与字节码解释完全委托给底层的 Python 解释器进程(例如 python.exe 或 Unix 系统下的 python3)。

当开发者点击“运行”或通过快捷键执行脚本时,开发工具会执行以下三项标准动作:第一,读取当前项目所绑定的解释器路径;第二,获取目标 .py 文件的完整绝对路径;第三,在指定的工作目录(Current Working Directory,简称 CWD)下派生出子进程,并将输出流实时导向集成控制台。

VS Code和PyCharm中配置并运行Python脚本的方法
图 1:VS Code 与 PyCharm 调度并执行 Python 脚本的通用架构流程图

二、VS Code 中配置并运行 Python 脚本

Visual Studio Code 是一款以插件驱动为核心的轻量级开发工具。其原生理应不包含 Python 调试器,必须通过安装官方语言服务拓展来提供环境识别功能。

1. 依赖准备与拓展安装

打开 VS Code,通过侧边栏的扩展面板(快捷键 Ctrl+Shift+X 或 macOS 下的 Cmd+Shift+X)搜索并安装由 Microsoft 官方维护的 Python 扩展。该扩展会自动捆绑安装 Pylance(语言分析与类型推断引擎)以及 Python Debugger 调试组件。

2. 创建工程目录与脚本

在 VS Code 中正确运行脚本的最佳实践始终是基于文件夹(Folder)模式打开。点击菜单栏 文件 -> 打开文件夹(Open Folder),选择你的工作根目录,随后在资源管理器中新建脚本文件 run_demo.py,编写如下测试代码:

import sys
import os

print("=== VS Code Python 运行检测 ===")
print("当前解释器路径:", sys.executable)
print("当前工作目录:", os.getcwd())
print("脚本执行成功!")

3. 指定与切换解释器

在未明确绑定解释器时,VS Code 会在右下角状态栏提示选择环境,或默认使用系统 PATH 中的第一个 Python。标准的手动选择步骤如下:

  1. 使用快捷键 Ctrl+Shift+P(macOS 为 Cmd+Shift+P)打开命令面板。
  2. 输入指令 Python: Select Interpreter(选择解释器)并回车。
  3. 在下拉列表中,VS Code 会列出自动扫描到的系统安装环境、Conda 环境以及项目目录下的虚拟环境(如 .venv)。
  4. 如果目标环境未被自动扫描到,点击 Enter interpreter path...(输入解释器路径),手动定位到该环境的二进制文件路径(Windows 为 Scripts/python.exe,Linux/macOS 为 bin/python)。

完成选择后,VS Code 会在当前工作区的 .vscode/settings.json 文件中自动记录如下配置:

{
  "python.defaultInterpreterPath": "/Users/example/my_project/.venv/bin/python"
}

4. 脚本执行方式

在 VS Code 中执行当前激活的脚本主要有三种途径:

  • 右上角运行按钮:在编辑器窗口右上角点击实心三角形的“在专用终端中运行 Python 文件”图标。
  • 右键上下文菜单:在代码编辑区域右键单击,选择“在终端中运行 Python 文件”。
  • 集成终端直接运行:按下 Ctrl+` 打开终端,确保虚拟环境已激活后,直接键入 python run_demo.py。
VS Code和PyCharm中配置并运行Python脚本的方法
图 2:VS Code 中从环境发现到最终终端运行的标准流程

三、PyCharm 中配置并运行 Python 脚本

与 VS Code 的插件组装模式不同,PyCharm(无论社区版还是专业版)是专为 Python 打造的集成开发环境。它具备强制的项目容器概念,通常在建立或打开项目之初就要求确定 Python 解释器。

1. 项目创建与解释器初始化

当通过 New Project 新建工程时,PyCharm 会在向导面板直接提供环境配置项:

  • New environment using Virtualenv:PyCharm 会在项目根目录下自动创建纯净的 venv 目录。
  • Previously configured interpreter:选择系统中已经存在的环境(如全局 Python、全局 Conda 环境)。

2. 在现有项目中变更或添加解释器

如果打开的是已有代码库,或者需要切换到特定环境,可按以下标准步骤进行操作:

  1. 打开设置窗口:Windows/Linux 下点击 File -> Settings(快捷键 Ctrl+Alt+S);macOS 下点击 PyCharm -> Preferences / Settings(快捷键 Cmd+,)。
  2. 在左侧导航树中展开 Project: [项目名称],点击 Python Interpreter。
  3. 点击右上角的 Add Interpreter 按钮,选择 Add Local Interpreter...。
  4. 在弹出的对话框中,根据实际环境类型选择:
    • Virtualenv Environment:可选择新创建或绑定已存在的环境(Existing),指定 python.exe。
    • Conda Environment:指定 conda.exe 路径并选取对应的 Conda 命名空间。
    • System Interpreter:指定系统全局安装的 Python 路径。
  5. 点击 Apply 并等待 PyCharm 完成后台索引建立(Indexing)。

3. 运行配置(Run/Debug Configurations)

PyCharm 的一大特性是显式维护每个运行任务的元数据。初次运行脚本时,最直观的操作是:

  • 在编辑器中右键点击代码任意位置,选择 Run '脚本名'(快捷键 Ctrl+Shift+F10 或 macOS Ctrl+Shift+R)。
  • 首次运行后,顶部工具栏会自动保留该脚本的“运行配置”。点击配置下拉框并选择 Edit Configurations...,可精细化指定:
    • Script path:脚本的绝对路径。
    • Parameters:需要传递给 sys.argv 的命令行参数。
    • Working directory:工作目录。PyCharm 默认将其设置为脚本所在文件夹或项目根目录。
    • Environment variables:注入自定义环境变量。
VS Code和PyCharm中配置并运行Python脚本的方法
图 3:VS Code 与 PyCharm 的架构维度与工程特性全景对照

四、两款工具的关键差异对比

对比维度 Visual Studio Code PyCharm (Community / Professional)
软件定位 轻量级多语言通用代码编辑器(插件驱动) 开箱即用的专业级 Python 集成开发环境(IDE)
解释器感知 依赖 Python 扩展,支持手动命令绑定 核心内置功能,强制与 Project 绑定,自动建立符号索引
运行入口 右上角快捷按钮、终端右键、或自定义 launch.json Run Configurations 菜单、右键运行、函数级入口按钮
工作目录逻辑 默认为当前打开的 Workspace 根目录 默认为模块所在目录或配置指定的 Content Root
第三方包安装 在内置终端中手动执行 pip install 提供可视化 Package 检索面板,也可在内置终端安装

五、常见问题排查与解决路径

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

该错误通常由以下两种原因引起:

  • 解释器不匹配:终端运行所使用的 Python 与编辑器当前选中的解释器并非同一个环境。在终端执行 pip list 确认包已安装,但若编辑器的解释器指向了另一个环境,则运行时依然会报错。解决方法:在 VS Code 重新执行 Select Interpreter,或在 PyCharm 的 Python Interpreter 设置中确认使用的路径就是刚刚执行 pip install 的虚拟环境。
  • 模块搜索路径问题:跨目录导入自定义模块时,VS Code 默认不会自动将子目录加入 sys.path。可在脚本顶部显式打印 sys.path 观察路径分布,或在 .env 文件中指定 PYTHONPATH=.。而在 PyCharm 中,若自定义模块标红,可在目标文件夹上右键选择 Mark Directory as -> Sources Root。

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

在 Python 中使用诸如 open("data/info.txt") 这类相对路径时,路径基准并不是该脚本所在的文件夹,而是执行时的工作目录(CWD)。若在 VS Code 根目录下运行深层子目录中的脚本,CWD 为项目根目录;而在 PyCharm 中右键直接运行,某些配置下默认以脚本所在文件夹为 CWD。规范做法:建议在代码中使用绝对锚定路径:

import os

BASE_DIR = os.path.dirname(os.path.abspath(__file__))
target_file = os.path.join(BASE_DIR, "data", "info.txt")

3. 控制台中文输出乱码

Windows 平台默认控制台代码页(Code Page)常见为 GBK(CP936),若 Python 脚本以 UTF-8 输出中文,容易产生乱码。解决办法是在运行环境变量中注入:

PYTHONIOENCODING=utf-8

在 VS Code 的 launch.json 中可通过 "env": {"PYTHONIOENCODING": "utf-8"} 注入;在 PyCharm 的 Run/Debug Configurations 面板中,展开 Environment variables 并添加该变量即可。

VS Code和PyCharm中配置并运行Python脚本的方法
图 4:Python 运行链路排查与异常恢复决策树

六、总结与工具选型建议

正确配置并运行 Python 脚本的关键在于明确解释器路径与上下文工作目录(CWD)。在实际项目开发中,建议遵循以下落地策略:

  • 对于个人工具脚本、数据处理、自动化运维脚本或资源受限的轻量级开发场景,推荐使用 VS Code,借助其轻便的启动速度和出色的多语言兼容能力快速执行。
  • 对于架构复杂、模块层级较多、多人协同或者深度依赖框架的中大型项目,推荐使用 PyCharm,利用其强大的代码分析重构、内置虚拟环境创建与严格的 Run Configurations 控制,大幅减少环境配置失误所耗费的时间。
  • 无论选用哪款工具,都强烈建议为每个独立项目建立专用的虚拟环境(venv 或 Conda),避免在全局系统 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 算法库。