PyCharm和VS Code怎么运行Python程序
详细讲解PyCharm与VS Code运行Python程序的核心原理、完整操作步骤、多种运行方式与常见报错排查,帮助初学者快速掌握Python代码执行与环境配置。
运行 Python 程序的核心逻辑十分纯粹:让计算机中安装的 Python 解释器去解析并执行你编写的代码文件。PyCharm 和 VS Code(Visual Studio Code)是当今最主流的两种 Python 开发工具。PyCharm 是专为 Python 打造的集成开发环境(IDE),开箱自带完整的工程体系与运行控制台;而 VS Code 则是高度灵活的现代代码编辑器,通过安装官方扩展与配置解释器实现轻量高效的运行。只要理清“选择解释器”与“触发运行”这两步,在这两款工具中运行 Python 都会变得非常直接。
一、准备工作:理解 Python 解释器的角色
无论是 PyCharm 还是 VS Code,本身都只是代码编辑工具,不能脱离 Python 解释器单独执行 Python 代码。计算机运行代码的底层本质是:编辑器通过系统调用命令 python 文件名.py,把代码送入对应的 Python 引擎中编译为字节码并逐行解释执行。
因此在开始之前,确保计算机系统已经安装了 Python:
- 在操作系统终端(Windows 的 CMD / PowerShell,或 macOS / Linux 的 Terminal)中输入
python --version或python3 --version。 - 如果能够正确打印出版本号(例如
Python 3.11.8),说明 Python 已经就绪。
二、在 PyCharm 中运行 Python 程序
PyCharm 是由 JetBrains 开发的重型 IDE,对 Python 项目有完整的工程管理模型。只要项目解释器配置完毕,运行代码只需一键即可。
1. 配置或检查解释器
首次运行脚本若提示没有解释器,可通过以下路径设置:
- 打开菜单栏:Windows 上点击
File > Settings;macOS 上点击PyCharm > Settings / Preferences。 - 在左侧列表中导航至
Project: [你的项目名] > Python Interpreter。 - 点击右上角的
Add Interpreter,选择Add Local Interpreter。 - 如果使用虚拟环境,选择
Virtualenv Environment并指定 Python 基础版本;或者选择System Interpreter直接使用系统全局 Python。 - 点击
OK保存,等待右下角索引建立完成。
2. 运行代码的具体操作
编写示例代码(如 main.py):
# main.py
def calculate_sum(a, b):
return a + b
if __name__ == "__main__":
result = calculate_sum(10, 25)
print(f"计算结果为: {result}")
执行该文件有以下四种最常用的方式:
- 右键菜单运行(最推荐初学者):在代码编辑区的任意空白区域点击鼠标右键,在弹出菜单中点击
Run 'main'(或使用快捷键 Ctrl+Shift+F10,macOS 为 Control+Option+R)。 - 右上角运行工具栏:当文件曾被运行过一次后,PyCharm 会自动将其加入右上角运行配置下拉框。直接点击旁边的绿色三角形图标(快捷键 Shift+F10,macOS 为 Control+R)即可再次运行。
- 代码左侧行号绿三角:在包含
if __name__ == '__main__':的代码行左侧边栏,会出现一个带有圆形底衬的绿色小三角,点击它并选择Run 'main'。 - 内置 Terminal 命令行:点击 PyCharm 底部窗口栏的
Terminal标签页,终端会自动激活该项目的虚拟环境,在命令行中输入python main.py并回车。
运行后,PyCharm 底部会自动弹出 Run 面板,展示执行路径、程序标准输出以及进程退出码 Process finished with exit code 0(退出码为 0 代表运行成功无异常)。
三、在 VS Code 中运行 Python 程序
VS Code 是一款基于插件机制的现代轻量代码编辑器。要流畅运行 Python,需要先安装微软官方的 Python 扩展插件,并通过状态栏或命令面板绑定解释器。
1. 安装 Python 官方扩展
打开 VS Code 后,点击左侧边栏的扩展图标(快捷键 Ctrl+Shift+X,macOS 为 Cmd+Shift+X),在搜索框中输入 Python,找到由 Microsoft 官方发布的扩展并点击 Install。该插件是 VS Code 具备代码运行、智能补全与断点调试能力的基础。
2. 选择 Python 解释器
安装完成后,必须告知 VS Code 使用哪个 Python 环境:
- 按下快捷键 Ctrl+Shift+P(macOS 为 Cmd+Shift+P)调出顶部命令面板。
- 在输入框中键入
Python: Select Interpreter并按回车。 - VS Code 会自动扫描本机已经安装的 Python 版本、虚拟环境或 Conda 环境,点击选用目标解释器即可。
- 成功绑定后,窗口右下角状态栏会显示当前所选解释器版本号(如
3.10.12 ('venv': venv))。
3. 运行代码的具体方式
使用 File > Open Folder 打开一个工作目录并新建 app.py,可通过以下几种常见方式运行:
- 右上角三角形运行按钮:打开
.py文件后,编辑器窗口右上角会出现一个三角形的“Play”图标。点击下拉菜单并选择 Run Python File。VS Code 会自动在下方拉起集成终端,激活对应的环境并打印执行结果。 - 右键菜单执行:在编辑区域内右键单击,在弹出的菜单中选择
Run Python > Run Python File in Terminal。 - 选中代码部分运行(Shift+Enter):高亮选中你想要测试的代码行,按下 Shift+Enter,VS Code 会在集成终端中启动 Python 交互式 REPL 会话并只执行选中的那几行,非常适合临时验证逻辑。
- 调试模式启动(F5 与 Ctrl+F5):按下 F5 可以启动内置调试器,支持断点单步排查;如果不需要打断点只想纯粹运行,按下快捷键 Ctrl+F5 即可快速执行。
四、进阶知识:调试模式与虚拟环境
日常开发不仅是简单运行代码,掌握断点调试与虚拟环境隔离同样必不可少:
- 断点调试(Debug):在代码行号左侧单击可以点亮一个红色圆点(断点)。运行调试后,程序会在断点处暂停,此时可在 PyCharm 的 Debug 面板或 VS Code 的 Run and Debug 侧边栏中实时查看所有变量的当前值、调用栈,并进行单步步过(Step Over)、步入(Step Into)操作。
- 虚拟环境隔离:不同项目依赖的第三方库版本各不相同。PyCharm 默认建议在创建项目时创建专属
venv;而 VS Code 也会自动检测当前项目目录下的.venv文件夹并提示使用。保证每个项目在独立虚拟环境中运行,能彻底规避库版本冲突。
五、常见运行报错与排查清单
在运行 Python 程序时,如果遇到报错,可以按照以下清单逐项排查:
| 常见报错 / 异常表现 | 根本原因 | 具体解决办法 |
|---|---|---|
No Python interpreter configured / 未配置解释器 |
IDE 未与本机安装的 Python 建立路径关联。 | PyCharm 进入 Settings > Python Interpreter 添加本地解释器;VS Code 按 Ctrl+Shift+P 搜索 Select Interpreter 绑定环境。 |
ModuleNotFoundError: No module named 'xxx' |
使用的库未安装在当前解释器中,或安装时混淆了全局与虚拟环境。 | 在当前 IDE 内置的 Terminal 中执行 pip install xxx,确保安装目标与当前选中的解释器保持一致。 |
'python' 不是内部或外部命令 |
系统 PATH 环境变量中未添加 Python 及 Scripts 安装路径。 | 重新运行 Python 安装包,务必勾选“Add python.exe to PATH”,或手动在系统环境变量中添加 Python 根目录。 |
| 代码运行一闪而过无输出 | 脚本末尾无输出打印或执行速度过快自动退出。 | 在 IDE 内置控制台或终端中运行即可保留完整输出;或在脚本末尾加上 print("完成") 确认执行流程。 |
六、PyCharm 与 VS Code 的特性与选型对比
了解两者的机制差异,有助于根据项目场景做出更合理的开发选择:
无论是选用专注于 Python 生态的 PyCharm,还是选用轻巧灵活的 VS Code,运行代码的核心逻辑是一致的:确保 Python 环境正确安装 -> 在软件中指定目标解释器 -> 触发运行并从控制台查看输出。理顺这一工作流后,便能根据日常学习、脚本编写或大型工程的不同需要,自如切换并高效执行代码。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









