Python零基础入门：环境搭建与运行第一个Hello World

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

在计算机中编写并执行 Python 代码，核心是安装 Python 解释器。解释器是一个负责读取、分析并逐行执行 Python 代码的程序。所有基础组件均由 Python 官方基金会免费提供。

获取安装包时，应认准 Python 官方下载通道：访问官方网站 https://www.python.org/downloads/。官网首页的 Downloads 导航项会根据当前访问者的操作系统，自动推荐适合的最新稳定安装包（如 Python 3.12.x 或 3.13.x）。

• Windows 系统用户：下载后缀为 .exe 的 Windows Installer（通常推荐 64-bit 版本）。
• macOS 系统用户：下载后缀为 .pkg 的 macOS 64-bit universal2 installer。

版本选择方面，当前所有日常开发、数据分析与自动化脚本均全面使用 Python 3 系列，切勿选择历史遗留的 Python 2 系列（已于 2020 年正式停止官方维护）。

二、核心操作：安装 Python 与关键配置选项

下载完成后，双击安装包即可启动图形化安装向导。对于绝大多数零基础学习者而言，Windows 环境下的安装向导包含一个极易被忽略但至关重要的配置复选框。

1. Windows 安装的关键步骤

运行安装程序后，在弹出的第一个界面底部，默认情况下并未勾选环境变量选项。请务必在此界面完成以下勾选：

• [√] Add python.exe to PATH：务必手动勾选该复选框。这一步会自动将 Python 解释器的安装目录写入 Windows 系统的全局环境变量，免去后续手动配置系统属性的复杂流程。
• [√] Use admin privileges when installing py.exe：保持默认勾选，确保启动器具备系统级调用权限。

勾选完成后，直接点击界面上方的 “Install Now” 即可进入自动化安装流程。安装完成后，若界面提示“Disable path length limit”（解除路径长度限制），建议点击该按钮以规避深层文件路径受限的问题，最后点击“Close”关闭安装器。

2. macOS 安装的关键步骤

macOS 用户双击打开下载好的 .pkg 文件后，按照向导提示一路点击“继续”并同意许可协议，输入 Mac 密码完成安装即可。macOS 安装包会自动在系统目录（如 /usr/local/bin）建立指向 Python 3 的符号链接。

三、机制解析：为什么必须配置 PATH 环境变量？

在新手学习交流中，“终端输入 python 提示命令不存在”是最频繁出现的问题。理解 PATH 环境变量 的作用机制，能帮助建立清晰的操作系统执行心智模型。

操作系统中的命令行终端本质是一个文本指令解释窗口。当我们在终端中输入一条命令（例如 python）并按下回车时，操作系统并不知道 python.exe 具体安装在硬盘的哪一个文件夹内。此时操作系统的寻址逻辑如下：

1. 首先在当前命令行所在的本地文件夹内查找是否存在 python.exe。
2. 如果当前目录不存在，系统就会去查阅名为 PATH 的全局环境变量列表。PATH 变量中记录了一连串受信任的文件夹路径清单。
3. 系统会自顶向下逐个遍历 PATH 列表中的文件夹。如果找到了目标可执行文件，立即调起运行；如果遍历完所有清单仍未找到，便会中断并向用户抛出报错提示。

如果在安装时勾选了“Add python.exe to PATH”，安装器就会把 Python 的安装根目录（如 C:\Python312\）及脚本目录自动追加到系统的 PATH 列表中。这样，无论你在哪一个文件夹路径下打开终端，系统都能瞬间找到 Python 解释器。

四、验证安装：在系统终端中检测执行环境

安装完成后，需要通过操作系统自带的命令行终端来验证 Python 是否已经正确安装并全局生效。请先关闭在安装前就已经开启的旧终端窗口，重新启动一个新窗口。

1. 打开终端的方式

• Windows 系统：按下键盘快捷键 Win + R，在弹出的“运行”输入框中输入 cmd 或 powershell，按回车键打开。
• macOS 系统：按下快捷键 Command + 空格 打开聚焦搜索（Spotlight），输入 Terminal 并回车打开“终端”。

2. 执行版本检测命令

在打开的黑底或白底终端窗口中，输入以下检测命令并按下回车：

python --version

命令执行后，如果配置正确，终端应立即返回安装好的具体版本号：

只要能够顺利输出以 Python 3. 开头的版本号，就证明 Python 解释器已经就绪，可以开始运行代码。

五、编写并运行第一个 Hello World

“Hello World”是编程领域中用于验证语言开发环境搭建成功的经典程序。在 Python 中，运行代码通常有两种方式：交互式终端模式（REPL） 与 脚本文件模式（.py）。这两种方式各自承担着不同的开发任务。

方式一：交互式环境（REPL 终端交互模式）

REPL 即“读取-求值-输出-循环”（Read-Eval-Print Loop）。在终端中输入命令进入解释器后，每输入一行 Python 代码，解释器就会立刻执行并返回计算结果。

1. 在终端中直接输入 python（macOS 输入 python3）并按下回车。
2. 终端光标左侧会出现由三个大于号组成的交互提示符：>>>。这代表已进入 Python 交互式环境。
3. 在提示符后键入输出语句，并按下回车执行：
   Python 交互式环境 (REPL) 代码输入

   >>> print("Hello, World!")

4. 回车后，终端将紧接着在下一行直接输出结果：
   交互终端即时执行结果
   Hello, World!
5. 退出交互模式：输入函数 exit() 并按回车；或者在 Windows 下按下快捷键 Ctrl + Z 后回车，在 macOS 下按下快捷键 Ctrl + D，即可退出并返回常规的系统命令行提示符。

方式二：脚本文件模式（编写 .py 文件批量运行）

交互式环境适合做临时的单行测试，但在实际软件开发中，代码必须保存在磁盘文件中才能反复编辑、持久留存与自动化执行。这就是脚本文件模式。

1. 新建文本文件：在电脑桌面或任意工作目录下新建一个空白文本文件，将其重命名为 hello.py。
   注意扩展名检查：Windows 默认可能会隐藏文件后缀名，导致文件实际名称变成了 hello.py.txt。请在 Windows 文件资源管理器的“查看”菜单中勾选“文件扩展名”，确保文件后缀确实为 .py。
2. 编写源码：用系统记事本或纯文本编辑器打开 hello.py，写入以下单行代码并保存文件：
   hello.py Python 源代码

   print("Hello, World!")

3. 在终端中导航到文件所在路径：打开系统终端，使用 cd（Change Directory）命令切换到保存 hello.py 的目录。例如如果保存在桌面：
   Terminal / Command Prompt 切换目录命令

   cd Desktop

4. 执行 Python 脚本：在当前目录下输入启动命令：
   Terminal / Command Prompt 运行脚本命令

   python hello.py

   （macOS 用户执行：python3 hello.py）

5. 查看输出结果：终端将顺序解释并执行该文件中的所有语句，打印出文本内容，随后自动结束进程并返回等待光标：
   终端执行结果
   Hello, World!

六、常见新手报错与排查指南

初次运行 Python 程序时，如果看到终端中跳出一长串红色或英文错误提示，不需要慌张。绝大部分起步阶段的异常都集中在环境路径识别、文件名以及基本语法格式上。

报错 1：'python' 不是内部或外部命令，也不是可运行的程序

• 具体表现：Windows 终端提示该信息；macOS 终端提示 zsh: command not found: python。
• 主要诱因：安装时未勾选“Add python.exe to PATH”；或者安装完成后未重启终端窗口。
• 修复方法： 首先关闭所有打开的终端窗口并重新打开一次，测试是否能正常识别。若仍未解决，重新双击运行最初下载的 Python 安装包，在弹出菜单中点击 “Modify”（修改），一路点击 Next 直至看到“Advanced Options”界面，勾选 “Add Python to environment variables”，点击 Install 完成配置。

报错 2：No such file or directory: 'hello.py'

• 具体表现：执行脚本时，终端提示 python: can't open file 'hello.py': [Errno 2] No such file or directory。
• 主要诱因：终端当前所在的工作目录与脚本文件实际存放的目录不一致；或者文件真实名称为 hello.py.txt。
• 修复方法： 在终端中输入 dir（Windows）或 ls（macOS）列出当前目录下的所有文件，查看是否存在 hello.py。如果不在，使用 cd 真实文件夹路径 切换至正确位置；检查文件管理器是否隐藏了文件扩展名。

报错 3：SyntaxError: invalid character 或 invalid syntax

• 具体表现：终端提示语法解析异常，如 SyntaxError: invalid character '“' 或 NameError: name 'Print' is not defined。
• 主要诱因：代码中混入了中文全角标点符号（如中文字符串引号“”、中文括号（））；或者将小写函数 print 误写成了大写开头的 Print。
• 修复方法： 将输入法切换为英文半角模式，确保括号 () 和引号 "" 均为纯半角 ASCII 字符。Python 严格区分英文字母大小写，所有核心关键字和内置函数均为小写。

七、核心要点回顾

完成 Python 环境搭建与首个程序运行后，可以回顾以下五个核心关键点：

• 官方来源：始终在官网获取对应系统的长期支持稳定安装包。
• 关键选项：Windows 安装务必勾选 Add python.exe to PATH。
• 先验环境：使用 python --version 确认系统已成功注册解释器。
• 双运行模式：交互式 REPL 适合单行测试，.py 脚本文件适合持久化工程开发。
• 严谨规范：编写代码全程使用英文半角标点符号，严格遵循大小写规则。

至此，计算机上已经拥有了一个完整、可用的标准 Python 编程环境。下一步可选择一款代码编辑器（如 VS Code 或 PyCharm Community），在更为高效的代码高亮与调试辅助环境中继续深入学习变量、数据结构与流程控制。