Python开发环境搭建与第一个程序运行教程

搭建 Python 开发环境的核心任务只有两件事：在计算机中安装能够解析执行代码的 Python 解释器，并将其路径正确注册到系统的 PATH 环境变量 中。只要完成这两步，无论使用系统自带的终端还是代码编辑器，都可以顺利编写并运行 Python 程序。本文将完整梳理从官方安装包获取、环境变量配置、终端校验，到使用编辑器编写并运行第一个脚本的完整过程。

一、认识 Python 运行环境的组成要素

许多初学者容易将“编写代码的软件”与“执行代码的程序”混淆。在正式安装之前，理清以下三个核心组件的关系，能够帮助排查后续可能遇到的多数路径与环境报错：

• Python 解释器（CPython）：这是 Python 环境的本体，通常对应系统中的 python.exe（Windows）或 python3（macOS/Linux）。它的职责是将人类可读的 .py 文本文件解析并翻译为机器能够理解的字节码执行。
• 环境变量 PATH：操作系统用来寻找可执行程序的检索路径列表。在命令行输入 python 时，系统会在 PATH 记录的各个文件夹中逐一检索对应程序，只有配置正确才能随处调用。
• 代码编辑器或 IDE：如 Visual Studio Code、PyCharm 或自带的 IDLE，本质上是辅助编写代码的工具，最终执行代码仍需调用系统中的 Python 解释器。

二、Python 官方安装包下载与安装细节

建议直接从 Python 官方网站（python.org）获取安装程序。进入官网后，导航至 Downloads 页面，网站会自动匹配访问者当前的操作系统类型（Windows 或 macOS）。通常下载页面中推荐的稳定版本（如 Python 3.11 或 3.12 稳定分支）即可满足绝大多数开发需求。

Windows 平台安装关键配置

双击运行下载好的 .exe 安装程序时，初始界面有两个至关重要的复选框：

1. Add python.exe to PATH（必须勾选）：位于安装窗口最底部。默认情况下此项未勾选，必须主动将其勾选上。未勾选会导致在控制台中输入 python 时提示找不到命令。
2. Use admin privileges when installing py.exe：保持默认勾选即可。
3. 选择安装方式：初学者若无特殊定制需求，直接点击界面上方的 Install Now；若希望更改安装路径（例如安装在 C:\Python312 而不是深层的 AppData 目录），可选择 Customize installation，在高级选项中勾选 Install for all users 并指定路径。

macOS 平台安装说明

macOS 用户下载 .pkg 安装包后，按照向导连续点击“继续”完成安装即可。需要注意的是，现代 macOS 系统自带了用于系统内部工具的 Python 环境，安装官方包后，终端中通常使用 python3 来代表新安装的 Python 3 解释器，使用 pip3 来管理包工具。

三、验证环境配置与交互式终端测试

安装完成后，不要立即急着写大段代码，先通过系统命令行验证 Python 与包管理工具 pip 是否已经可以在全局正常被调用。

1. 打开系统终端

• Windows：按下快捷键 Win + R，在运行对话框中输入 cmd 或 powershell 并回车。
• macOS：按下快捷键 Command + 空格 打开聚焦搜索，输入 Terminal（终端）并回车。

2. 执行版本检查命令

在终端窗口中输入以下命令并按下回车：

python --version
pip --version

如果是在 macOS 下且 python 命令无效，请执行：

python3 --version
pip3 --version

正常输出示例：

Python 3.12.2
pip 24.0 from C:\Python312\Lib\site-packages\pip (python 3.12)

3. 快速体验 REPL 交互模式

直接在终端中敲入 python（或 python3）并回车，终端提示符会变为三个大于号 >>>。这代表进入了 Python 的交互式编程环境（Read-Eval-Print Loop）：

>>> print("Hello, Python!")
Hello, Python!
>>> 1 + 2 * 3
7
>>> exit()

交互环境适合临时测试单行代码或查看函数说明。要退出交互环境回到系统终端，输入 exit() 并回车，或在 Windows 下按 Ctrl + Z 回车，macOS 下按 Ctrl + D 即可。

四、编写第一个 Python 脚本文件

交互式命令行无法保存代码，正式开发必须将代码保存在 .py 结尾的纯文本文件中。推荐使用 Visual Studio Code（简称 VS Code） 作为代码编辑器，它轻量免费且插件生态完善。

1. 准备项目工作目录与脚本

1. 在电脑硬盘中选择一个合适的位置（如 D:\Projects\PythonQuickStart），新建一个文件夹，文件夹名称尽量使用全英文，不要包含空格。
2. 在 VS Code 中点击菜单 File -> Open Folder，打开刚刚创建的文件夹。
3. 在侧边栏文件树中点击“新建文件”图标，命名为 hello.py。

2. 编写脚本内容

在 hello.py 中输入以下内容。这段代码展示了控制台输出、变量赋值以及基础的数学运算：

# hello.py
# 我们的第一个完整Python脚本

# 打印问候语
print("====================================")
print("恭喜！你的第一个 Python 程序运行成功！")
print("====================================")

# 定义变量与简单交互
user_name = "Python学习者"
course_year = 2026

print(f"你好，{user_name}，欢迎进入编程世界。")
print(f"当前运行年份：{course_year}")

五、运行 Python 程序的两种标准方式

方式一：在终端命令行中显式运行（最稳妥通用）

无论在任何编辑器或纯文本工具中编写的代码，都可以通过操作系统的控制台直接运行。在 VS Code 顶部菜单选择 Terminal -> New Terminal（终端 -> 新建终端），或者在外部 CMD / PowerShell 中 cd 到脚本所在目录：

python hello.py

如果是在 macOS / Linux 环境中，对应命令为：

python3 hello.py

回车后即可在终端中看到脚本打印出的各行文本。

方式二：使用 VS Code 顶部的一键运行按钮

在 VS Code 的扩展商店（Extensions）中搜索安装微软官方提供的 Python 扩展插件。安装后，当打开任意 .py 文件时，窗口右上角会出现一个绿色的 三角形“运行”图标。直接点击该图标，VS Code 会自动在下方唤出集成终端并代为输入执行命令。

六、新手常见问题与排错清单

在实际搭建与初次运行过程中，若遇到异常，可按表 1 快速排查：

完成上述所有步骤后，计算机上已经拥有了标准且健康的 Python 编程基础。后续无论继续学习基础语法、安装第三方数据分析或 Web 开发模块，都可以基于当前搭建的解释器与编辑器平稳展开。