新手怎么用VS Code或PyCharm运行第一个Python程序

拾柒

发布时间：2026-10-26 | 7人浏览过

原创

运行第一个 Python 程序，本质上只需要理清两件事：计算机里必须安装好 Python 解释器，以及用一个工具把写好的代码交给解释器去执行。许多初学者在此卡壳，往往不是因为代码写错了，而是混淆了“编辑器”与“解释器”的边界。无论是轻便灵活的 Visual Studio Code（简称 VS Code），还是功能集成完备的 PyCharm，只要掌握“识别解释器、创建文件、触发运行”的核心闭环，几分钟内就能顺利在屏幕上看到属于自己的第一行输出。

一、前置基石：理解编辑器与解释器的关系

在动手打开软件前，先澄清一个常见误区：安装 VS Code 或 PyCharm 并不等于安装了 Python。这两个软件都属于代码编写与项目管理工具，真正负责逐行解析代码并输出结果的核心引擎是 Python 解释器（即官方的 python.exe 或系统中的二进制执行文件）。如果系统中没有解释器，任何编辑器都无法把 print("Hello, World!") 转换成计算机能理解的指令。

可以通过系统的终端或命令行工具验证本机是否已准备就绪：

python --version
# 如果提示无此命令，在 macOS 或 Linux 上可以尝试：
python3 --version

如果控制台能返回类似 Python 3.11.x 或 Python 3.12.x 的版本编号，说明底层环境已经就位；如果提示“不是内部或外部命令”或“command not found”，则需要先前往 Python 官方网站下载安装包。在 Windows 系统安装时，务必在初始界面勾选“Add python.exe to PATH”，这一步能将解释器自动注入系统全局路径，省去后续大量的配置排错成本。

新手怎么用VS Code或PyCharm运行第一个Python程序 — 图 1：VS Code 与 PyCharm 架构理念与新手适配特性对比

二、使用 VS Code 运行第一个 Python 程序

VS Code 官方原生只是一个通用文本编辑器。要让它具备调试、语法高亮与一键运行 Python 的能力，需要通过官方插件与工作区配置建立连接。具体操作分为四个明确的步骤：

1. 安装 Microsoft 官方 Python 扩展

打开 VS Code，点击最左侧活动栏的方块图标（Extensions / 扩展，快捷键 Ctrl+Shift+X 或 macOS 下的 Cmd+Shift+X）。在搜索框中键入 Python，选择由 Microsoft 官方发布的扩展项，点击“Install”。该扩展会自动安装配套的 Pylance（提供代码高亮与自动补全）和 Python Debugger（提供断点调试功能）。

2. 打开工作目录并新建 Python 文件

不要直接新建无归属的孤立文件。在顶部菜单栏选择 File -> Open Folder...（文件 -> 打开文件夹），在本地磁盘创建一个专门用于练习的文件夹（例如 D:\PythonProjects\demo 或 ~/Documents/python_demo），然后点击打开。随后在左侧资源管理器中，点击新建文件按钮，输入文件名 hello.py。注意必须以 .py 结尾，VS Code 才能识别出这是 Python 源文件。

3. 选择关联的 Python 解释器

打开 hello.py 后，观察 VS Code 界面右下角的状态栏。如果显示类似 Python 3.x.x 的文字，说明插件已自动识别到本地环境；如果显示 Select Interpreter（选择解释器），则需点击该按钮，或者在键盘上按下 Ctrl+Shift+P（macOS 为 Cmd+Shift+P），输入：

Python: Select Interpreter

在弹出的下拉列表中，选择带有“Global”或系统默认路径的 Python 版本。选择完毕后，状态栏会固定显示当前绑定的 Python 版本号。

4. 编写代码并触发执行

在编辑器区域键入标准的入门代码：

# hello.py
print("Hello, Python from VS Code!")
print("运行成功：解释器环境配置正常。")

编写完成后按快捷键 Ctrl+S（macOS 为 Cmd+S）保存文件。此时有两种最简捷的运行方式：

按钮运行：点击代码编辑区右上角由 Python 插件注入的“播放”小三角形图标（Run Python File）。
终端运行：按下 Ctrl+` 打开内置集成终端，手动输入 python hello.py 并回车。

VS Code 会自动拉起终端面板，调用指定的解释器执行该脚本，并在下方输出对应文本。

三、使用 PyCharm 运行第一个 Python 程序

与 VS Code 的轻量扩展模式不同，PyCharm（建议新手下载免费开源的 Community 社区版）是一个完整的集成开发环境。它的工作流强调“工程（Project）”观念，所有的代码文件都存放在特定的项目边界中，且自带独立的环境隔离策略。

1. 新建工程（New Project）并配置虚拟环境

启动 PyCharm 后，在欢迎界面点击 New Project（新建项目）。在配置界面中注意两个关键配置项：

Location（项目路径）：指定本地保存路径，建议路径中不要包含中文或特殊字符，例如 D:\pycharm_projects\first_demo。
Python Interpreter（解释器环境）：初学者建议保持默认的 New environment using Virtualenv。PyCharm 会自动读取系统中已安装的基础 Python（Base Python），并在项目根目录下创建一个名为 .venv 的独立沙盒。这种虚拟环境机制可以确保未来安装第三方库时互不干扰。

配置无误后点击右下角 Create，PyCharm 会自动生成工程骨架并建立初始代码索引。

2. 创建 Python 源代码文件

工程初始化完成后，左侧会出现 Project 文件目录树。右键点击最顶层的项目根目录名称，在右键菜单中依次选择：

New -> Python File

在弹出的小对话框中输入文件名（例如 main），按回车确认。PyCharm 会自动补齐 .py 扩展名并在主编辑区打开该文件。

3. 编写代码并触发执行

在编辑区域输入第一行测试代码：

# main.py
print("Hello, PyCharm!")
print("当前工程虚拟环境初始化成功。")

在 PyCharm 中运行文件的方式非常直观且多样：

编辑区右键运行：在代码编辑区的任意空白处点击鼠标右键，在上下文菜单中点击 Run 'main'（快捷键为 Ctrl+Shift+F10，macOS 为 Ctrl+Shift+R）。
右上角运行三角：首次右键运行后，PyCharm 会自动生成该文件的运行配置（Run Configuration），此后可以直接点击右上角的绿色实心三角形按钮。

点击后，PyCharm 底部会自动弹出 Run 控制台窗口，首先显示执行所调用的虚拟环境解释器完整绝对路径，随后完整打印输出内容，并在结尾标注：

Process finished with exit code 0

在计算机系统中，退出码 0（Exit Code 0）是国际通行的约定，意味着程序执行完全正常，未遇到任何未捕获的崩溃或异常。

四、初次运行常见报错与排查决策

在实际操作中，新手极易因细微的系统设置或操作顺序差异遇到报错。绝大部分初次运行故障都可以归纳为以下三种典型表现：

防踩坑要点：遇到报错时，优先看终端输出的第一行与最后一行。第一行记录了系统尝试执行的完整路径，最后一行标注了具体的错误类型（Error Type）。切忌盲目反复点击运行，应根据错误特征针对性调整配置。

此外还有一个高频隐蔽细节：在 Windows 操作系统中，如果系统默认隐藏了已知文件扩展名，新手新建文本文件并重命名为 hello.py 时，实际全名可能变成了 hello.py.txt。此时无论在 VS Code 还是命令行中执行 python hello.py，都会提示找不到该文件。建议在文件资源管理器的“查看”菜单中，务必勾选“文件扩展名”。

五、工具选择总结与新手后续建议

完成第一个程序的运行后，你已经成功建立了代码编写与环境调用的基本感知。关于后续该选用哪个工具长期学习，可以参考以下具体建议：

选择 VS Code 的情况：如果你的计算机内存较小（如 8GB 或以下）、偏好轻巧灵敏的交互响应、或者后续计划兼顾 HTML/CSS/JavaScript、C/C++、Go 等多语言开发，VS Code 是极具性价比的长期伴侣。它的插件化机制能让你清晰看懂开发工具背后的每个调用环节。
选择 PyCharm 的情况：如果你在较长一段时间内将精力全力倾注在 Python 学习、数据挖掘或 Django/Flask 后端开发上，且设备内存充裕（推荐 16GB 及以上），PyCharm Community 能够省去大量寻找和搭配插件的心智负担。它强大的变量追踪、代码重构、包管理界面能够让初学者把注意力真正聚焦在语言逻辑本身。

无论选用哪一款工具，核心都在于建立“脚本文件 -> 指定解释器 -> 观察控制台输出”的直观心智模型。走通这一步，编写第一个 Python 程序的目标便已圆满达成，接下来即可安心步入变量、控制流与函数等语法核心知识的探索之旅。