Python怎么安装配置并运行第一个程序

一、准备工作与官方安装包获取

Python 是跨平台的高级编程语言，官方由 Python 软件基金会（Python Software Foundation）维护。搭建开发环境的第一步，必须是从官方渠道获取经过数字签名验证的安装程序，以避免第三方下载站绑定的广告插件或篡改版本。

打开浏览器，访问 Python 官方网站：https://www.python.org/。在页面顶部导航栏中，将鼠标悬停在 Downloads 菜单项上，网站会自动侦测你当前使用的操作系统，并高亮推荐当前最新的稳定版本（如 Python 3.12.x 或 3.13.x）。

• Windows 用户：点击下载按钮，将直接获取名为 python-3.x.x-amd64.exe 的可执行安装程序（对应 64 位系统）。
• macOS 用户：点击下载获取 python-3.x.x-macos11.pkg 安装包（通常为兼容 Intel 与 Apple Silicon 芯片的通用通用安装包 Universal2）。
• 版本选择原则：对于绝大多数学习者和常规项目，始终选择“Python 3”的最新稳定发行版即可。请勿下载早期的 Python 2 系列（该分支已于 2020 年正式停止官方维护并退役）。

二、Windows 系统的安装与环境变量配置

在 Windows 平台上，安装过程最关键的决定发生在打开安装向导的第一秒。双击刚刚下载的 .exe 安装程序，向导会呈现初始配置界面。

为什么勾选 Add python.exe to PATH 如此重要？操作系统在执行控制台命令时，并不会主动在整个硬盘中漫无目的地搜索每一个文件夹。它只会在名为“PATH”的系统环境变量所记录的固定目录列表里寻找对应的可执行文件。勾选该选项后，安装器会自动将 Python 的安装根目录（包含 python.exe）以及辅助脚本目录（包含 pip.exe）写入系统 PATH。这意味着日后无论你在硬盘的哪个文件夹下打开命令行，系统都能立刻定位并调起 Python 解释器。

勾选复选框后，直接点击上方的 Install Now（立即安装）。安装向导会自动解压核心库、标准库组件并完成关联配置。安装完成提示界面出现后，如果看到 Disable path length limit（解除 260 字符文件路径限制）的按钮，建议顺手点击一次并确认管理员授权，最后点击 Close 完成安装。

三、macOS 系统的安装与环境特点

macOS 系统的默认环境与 Windows 存在少许差异。虽然现代 macOS 系统内置了部分基础运行时，但那些属于系统自用组件，通常不完整且不包含第三方包管理工具，因此依然需要安装官方 Python。

双击下载得到的 .pkg 文件，按照安装助手提示连续点击“继续”并同意许可协议，输入 Mac 开机密码即可完成安装。macOS 的官方安装包会自动将可执行文件软链接至 /usr/local/bin 目录，该目录在系统默认的 PATH 查找路径之内。

四、验证安装与理解 Python 运行模式

安装完成后，必须进入操作系统的真实命令行环境对安装结果进行检验。

如何打开终端：

• Windows 系统：按下键盘上的快捷键 Win + R，在弹出的“运行”对话框中输入 powershell 或 cmd，按下回车键；或者在任务栏搜索框直接搜索“终端”或“PowerShell”并打开。
• macOS 系统：按下 Command + 空格键 唤起聚焦搜索（Spotlight），输入 Terminal 或“终端”，按下回车键打开。

在打开的终端窗口光标后，键入以下命令并按下回车，用以查看当前 Python 解释器的版本信息：

python --version
# 如果是 macOS 系统，请执行：
python3 --version

Python 3.12.2

只要控制台输出了形如 Python 3.x.x 的具体版本号，就代表 Python 已经正确安装在你的电脑上，且系统环境变量已成功识别该命令。同理，你可以输入 pip --version（或 pip3 --version），校验包管理器是否同时可用。

区分两种工作模式：交互式环境 vs 脚本模式

初学者最容易产生困惑的地方在于：我现在到底是在系统的终端里，还是在 Python 的环境里？

1. 交互式环境（REPL）：如果在终端中只输入 python 并回车，终端的行首提示符会从原本的文件夹路径（如 C:\Users\Admin> 或 mac:~ $）变成三个连续的大于号 >>>。这表示你已经进入了 Python 的即时交互解释器中。此时你敲下的每一句代码都会在回车后立刻计算并显示结果。在 >>> 提示符下，操作系统的命令（如 cd、dir）将全部失效。如果想返回系统终端，必须输入 exit() 并按回车。
2. 脚本执行模式：在实际编写项目时，我们不会每次都在 >>> 里单行敲代码，而是将代码保存在 .py 文件中，然后在系统终端里使用 python 文件名.py 调用解释器整体执行。

五、编写并运行第一个 Python 程序

接下来，我们将按照正规的开发规范，完整走一遍从创建源文件、编写打印代码、通过终端进入目录，到最终执行输出的全流程。

步骤 1：创建工作目录与脚本文件

建议在电脑中专门规划一个学习代码的文件夹，例如在 D 盘或用户文稿目录下新建一个名为 python_demo 的文件夹。

进入该文件夹后，点击鼠标右键新建一个纯文本文档，并将其重命名为 hello.py。

步骤 2：在文件中写入代码

右键点击 hello.py，选择“通过记事本打开”（或者使用 Visual Studio Code、Sublime Text 等专业文本编辑器）。在文件中输入以下内容：

print("Hello, World!")

代码解析与字符要求：

• print 是 Python 内置的输出函数，功能是将其内部包裹的内容输出打印到终端控制台。所有字母必须严格小写。
• 英文半角小括号 () 是函数的调用符号。
• 双引号 "Hello, World!" 表示一段文本字符串。必须使用英文半角引号。如果不慎使用了中文输入法下的全角引号 “” 或括号 （），Python 解释器会直接报语法错误。

输入完毕后，按下键盘快捷键 Ctrl + S（Mac 为 Command + S）保存文件，并关闭编辑器。

步骤 3：在终端中切换到文件所在目录

打开系统终端。此时终端默认停留在系统的用户主目录，我们需要使用 cd（Change Directory）命令切换到存放 hello.py 的目录。

# Windows 系统切换跨盘符目录：
d:
cd python_demo

# macOS 或 Linux 系统切换目录：
cd ~/Documents/python_demo

在 Windows PowerShell 中，你也可以输入 dir，或者在 Mac 终端中输入 ls，按下回车后终端会列出当前文件夹下的文件列表。如果能看到 hello.py 列在其中，说明当前工作目录已精准就绪。

步骤 4：唤起解释器执行脚本

在已经进入该目录的终端窗口中，键入以下执行指令：

python hello.py
# 如果是 macOS 系统：
python3 hello.py

Hello, World!

当屏幕上清晰地打印出 Hello, World!，且光标换行重新回到系统的提示符时，说明 Python 解释器已经成功读取了你编写的源文件，将其编译为字节码并解释执行完毕。至此，你的第一个 Python 程序正式运行成功。

六、初学者常见报错与快速排查决策

在初次配置环境和运行代码的过程中，遇到报错是非常普遍的现象。以下总结了新手高频出现的 4 类典型报错现象及其精准排查方法。