VS Code和PyCharm中配置并运行Python脚本的方法
全面解析在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 中配置并运行 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。标准的手动选择步骤如下:
- 使用快捷键
Ctrl+Shift+P(macOS 为Cmd+Shift+P)打开命令面板。 - 输入指令
Python: Select Interpreter(选择解释器)并回车。 - 在下拉列表中,VS Code 会列出自动扫描到的系统安装环境、Conda 环境以及项目目录下的虚拟环境(如
.venv)。 - 如果目标环境未被自动扫描到,点击
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。
三、PyCharm 中配置并运行 Python 脚本
与 VS Code 的插件组装模式不同,PyCharm(无论社区版还是专业版)是专为 Python 打造的集成开发环境。它具备强制的项目容器概念,通常在建立或打开项目之初就要求确定 Python 解释器。
1. 项目创建与解释器初始化
当通过 New Project 新建工程时,PyCharm 会在向导面板直接提供环境配置项:
- New environment using Virtualenv:PyCharm 会在项目根目录下自动创建纯净的
venv目录。 - Previously configured interpreter:选择系统中已经存在的环境(如全局 Python、全局 Conda 环境)。
2. 在现有项目中变更或添加解释器
如果打开的是已有代码库,或者需要切换到特定环境,可按以下标准步骤进行操作:
- 打开设置窗口:Windows/Linux 下点击
File -> Settings(快捷键Ctrl+Alt+S);macOS 下点击PyCharm -> Preferences / Settings(快捷键Cmd+,)。 - 在左侧导航树中展开
Project: [项目名称],点击 Python Interpreter。 - 点击右上角的
Add Interpreter按钮,选择Add Local Interpreter...。 - 在弹出的对话框中,根据实际环境类型选择:
- Virtualenv Environment:可选择新创建或绑定已存在的环境(Existing),指定
python.exe。 - Conda Environment:指定
conda.exe路径并选取对应的 Conda 命名空间。 - System Interpreter:指定系统全局安装的 Python 路径。
- Virtualenv Environment:可选择新创建或绑定已存在的环境(Existing),指定
- 点击 Apply 并等待 PyCharm 完成后台索引建立(Indexing)。
3. 运行配置(Run/Debug Configurations)
PyCharm 的一大特性是显式维护每个运行任务的元数据。初次运行脚本时,最直观的操作是:
- 在编辑器中右键点击代码任意位置,选择 Run '脚本名'(快捷键
Ctrl+Shift+F10或 macOSCtrl+Shift+R)。 - 首次运行后,顶部工具栏会自动保留该脚本的“运行配置”。点击配置下拉框并选择 Edit Configurations...,可精细化指定:
- Script path:脚本的绝对路径。
- Parameters:需要传递给
sys.argv的命令行参数。 - Working directory:工作目录。PyCharm 默认将其设置为脚本所在文件夹或项目根目录。
- Environment variables:注入自定义环境变量。
四、两款工具的关键差异对比
| 对比维度 | 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 并添加该变量即可。
六、总结与工具选型建议
正确配置并运行 Python 脚本的关键在于明确解释器路径与上下文工作目录(CWD)。在实际项目开发中,建议遵循以下落地策略:
- 对于个人工具脚本、数据处理、自动化运维脚本或资源受限的轻量级开发场景,推荐使用 VS Code,借助其轻便的启动速度和出色的多语言兼容能力快速执行。
- 对于架构复杂、模块层级较多、多人协同或者深度依赖框架的中大型项目,推荐使用 PyCharm,利用其强大的代码分析重构、内置虚拟环境创建与严格的 Run Configurations 控制,大幅减少环境配置失误所耗费的时间。
- 无论选用哪款工具,都强烈建议为每个独立项目建立专用的虚拟环境(venv 或 Conda),避免在全局系统 Python 中随意安装库,从根本上隔离版本冲突。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









