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

一、准备工作与解释器获取

计算机本身无法直接理解人类编写的 Python 代码。我们在电脑上编写的代码，需要经过一个名为“Python 解释器”（官方标准实现为 CPython）的软件逐行读取并翻译成计算机硬件能够执行的机器指令。因此，所谓“搭建 Python 环境”，第一步就是下载并安装这个解释器。

获取 Python 解释器的正规途径是访问官方网站 python.org。在导航栏的 Downloads 区域，网站会根据当前访问的操作系统自动推荐最新发布的稳定版本（Stable Release）。对于零基础学习者，建议遵循以下两条选型准则：

• 选择当前受支持的稳定版：直接选择官网首页推荐的稳定大版本（如 Python 3.11 或 3.12 系列），避免选择带有 Alpha、Beta 或 RC 标签的测试版。
• 匹配计算机硬件架构：现代个人计算机绝大多数为 64 位系统，Windows 用户下载 Windows installer (64-bit)，macOS 用户下载通用的 macOS 64-bit universal2 installer。

二、Windows 与 macOS 安装关键步骤

不同操作系统的安装包格式与界面不同，其中 Windows 平台的安装步骤存在一个直接决定后续能否正常使用的关键选项。

1. Windows 系统的安装规范

双击下载好的 .exe 安装程序后，会弹出安装向导首页。此时切勿直接点击下一步，请务必关注窗口底部：

• 勾选“Add python.exe to PATH”：这是新手最容易遗漏的步骤。勾选此项后，安装器会自动将 Python 的安装路径及其 Scripts 目录追加到 Windows 系统的全局环境变量 PATH 中。如果未勾选，系统在命令行中找不到 python 命令，就会提示“不是内部或外部命令”。
• 选择安装方式：点击上方的 Install Now（立即安装）。向导会自动将 Python 解释器、标准库以及包管理工具 pip 部署到默认目录。
• 完成安装：安装进度结束后，界面会显示“Setup was successful”。直接点击 Close 关闭向导即可。

2. macOS 系统的安装规范

双击下载的 .pkg 文件后，系统会启动标准安装助手。macOS 用户只需按照提示连续点击“继续”并同意许可协议，输入开机密码授权安装即可。macOS 安装器会自动配置软链接，将 python3 和 pip3 注册到 /usr/local/bin 或 /opt/homebrew/bin 中。

三、验证环境是否安装成功

安装完成后，需要通过系统命令行终端确认 Python 解释器是否已成功就绪。

首先打开系统终端：

• Windows：按下快捷键 Win + R，在运行窗口中输入 cmd，按下回车打开“命令提示符”；也可以在开始菜单搜索“PowerShell”。
• macOS：按下快捷键 Command + 空格 呼出聚焦搜索（Spotlight），输入 Terminal 或“终端”并回车。

在光标处输入以下命令并回车执行：

python --version

如果环境变量配置正常，终端将在一行内回显当前的 Python 版本信息。以下为预期的示例输出：

Python 3.12.3

四、运行第一个程序：两种核心方式的对比与实践

运行 Python 代码主要有两种方式：一是进入终端交互式解释器（REPL）逐行运行，二是将代码写入独立脚本文件（.py）后由解释器整体调度。理解这两种方式的运作差异，是建立编程思维的重要一环。

方式一：终端交互式解释器（REPL 模式）

在打开的命令提示符或终端中，直接输入 python 并回车（macOS 输入 python3）：

python

此时终端会打印 Python 的版本号及系统版权信息，并将最左侧的命令提示符替换为三个大于号 >>>。这代表已经进入了 Python 的交互式解释环境（即 REPL：读取 Read、求值 Eval、打印 Print、循环 Loop）。

在 >>> 后面输入以下代码并按下回车：

print("Hello, World!")

按下回车的一瞬间，解释器会立即在下方输出结果，并重新呈现 >>> 提示符等待下一条指令：

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

若要退出交互模式返回操作系统的普通命令行，可以在 >>> 提示符后输入 exit() 回车；或直接使用快捷键：Windows 按 Ctrl + Z 然后回车，macOS 按 Ctrl + D。

方式二：保存并执行脚本文件（.py 模式）

虽然交互模式非常直观，但它有一个根本限制：一旦窗口关闭，刚才输入的代码就会从内存中彻底消失。在实际开发中，程序都保存在扩展名为 .py 的纯文本文件中。

1. 创建代码文件：在电脑中挑选一个目录（例如 D:/python_study 或 macOS 的用户目录），新建一个名为 hello.py 的纯文本文件。推荐使用 VS Code 等代码编辑器打开该文件。
2. 写入并保存代码：在 hello.py 中写入单行打印语句并保存文件：
   hello.py 源码Python

   print("Hello, World!")

3. 在终端中调度执行：打开系统命令行终端，先使用 cd 命令切换至该文件所在文件夹，然后调用 Python 解释器执行该脚本：
   终端操作命令Terminal / CMD

   # 1. 切换至文件所在文件夹 (示例路径)
   cd D:/python_study
   
   # 2. 调用解释器执行 hello.py
   python hello.py

执行后，终端会打印出对应的结果并直接退出 Python 进程，将终端控制权归还给操作系统：

Hello, World!

关键差异分析：为什么这两种方式都必不可少？

初学者常常困惑：既然可以用一行命令直接打印，为什么还要大费周章创建文件？两者在机制与用途上有明确的分野：

核心差异的影响：交互式环境让学习者免去文件管理的开销，能够在几秒钟内验证一段语法是否正确；而脚本文件则是工业软件的基石。在日后的学习中，我们通常在交互式终端中快速“探索”，在脚本文件中完成“构建”。

五、新手初次运行常见报错与排查决策

在搭建环境与运行第一个程序的过程中，极少数人能一次不错。以下四类问题覆盖了绝大多数新手所遭遇的瓶颈，按图索骥即可快速定位与解决。

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

原因剖析：操作系统的命令行在接到 python 命令后，会在全局环境变量 PATH 所记录的所有文件夹中逐一搜索 python.exe。若搜索完毕仍未找到，便会抛出此错误。这说明安装时未勾选“Add python.exe to PATH”，或者安装完成后没有重启已打开的终端。

解决方法：

1. 重新运行最初下载的 Python 安装程序；
2. 在弹出的界面中点击 Modify（修改），勾选 Add python.exe to PATH，然后一路点击 Next 完成修复；
3. 彻底关闭当前已经打开的所有 CMD 或 PowerShell 窗口，重新启动一个新终端，再次尝试 python --version。

2. 报错：SyntaxError: invalid character in identifier

原因剖析：Python 的语法解析器要求所有的结构性符号（包括括号、引号、逗号、冒号）必须是半角英文字符。如果在输入代码时未切换输入法，输入了全角中文括号 （） 或中文引号 “”，解释器就无法识别这些双字节符号，从而报告语法错误。

解决方法：检查报错指出的行号，将中文标点删除，将输入法切换到纯英文状态，重新输入标准半角标点 print("Hello, World!")。

3. 报错：FileNotFoundError: [Errno 2] No such file or directory: 'hello.py'

原因剖析：在终端输入 python hello.py 时，操作系统只会在当前工作目录（Current Working Directory）下寻找该文件。如果你的文件保存在桌面上，而终端默认打开在用户个人主目录，终端就找不到该文件。

排查与修复步骤：

• 在终端中输入 dir（Windows）或 ls（macOS）并回车，检查列出的文件列表中是否有 hello.py。
• 如果不在列表中，使用 cd 你的文件夹绝对路径 命令切换到目标文件夹，例如：cd C:/Users/Username/Desktop，然后再执行 python hello.py。

4. 运行无报错也无反应，或者文件实际变成了 hello.py.txt

原因剖析：Windows 系统的默认设置会“隐藏已知文件类型的扩展名”。初学者如果使用系统自带的“记事本”新建文件并命名为 hello.py，记事本往往会自动在末尾悄悄加上 .txt，真实的文件全名变成了 hello.py.txt。

解决方法：

1. 打开 Windows 文件资源管理器，点击顶部的“查看”菜单（Windows 11 点击“查看” -> “显示”）；
2. 勾选“文件扩展名”；
3. 此时回到文件列表，会发现原本的 hello.py 显露出了全名 hello.py.txt。右键选择重命名，将末尾多余的 .txt 删掉并确认更改即可。

六、全文总结

完成 Python 环境搭建并打印出第一行“Hello, World!”，标志着计算机系统已经能够正确调度 Python 解释器。回顾整个过程，核心在于把握三个关键环节：

• 系统层：通过环境变量 PATH 建立系统命令行与解释器可执行文件之间的寻址通路；
• 实践层：理清即时探索（REPL 交互）与工程编码（.py 脚本文件）各自的适用边界与机制差异；
• 排障层：面对命令行无响应、字符编码、语法标点与工作路径不符等基础异常，能够结合错误回显精准定位于特定环节。

环境就绪后，接下来即可安装专用的代码编辑器（如 Visual Studio Code），开始系统学习变量、数据类型与流程控制等核心语法。