Python新手入门教程：从环境安装到第一个程序

一、准备与安装：为什么勾选 PATH 是核心步骤

许多初学者在第一次安装 Python 时，容易误以为只要双击安装包、一路点击“下一步”就算完成。然而，这种习惯往往会导致后续在命令行键入指令时提示“找不到命令”。

计算机本质上是一个依照路径查找文件的系统。操作系统内部维护着一个名为 PATH 的环境变量，它是一串文件夹路径清单。当你在终端输入 python 时，系统会沿着这串清单逐一搜索名为 python.exe 的程序。如果安装时没有将 Python 所在的文件夹加进 PATH 清单，系统就无法知道这个命令对应磁盘上的哪一个文件。

1. 获取官方安装包

建议直接从 Python 官方网站（python.org/downloads）获取官方安装包。对于初学者，无需盲目追逐最新的预发布测试版（Pre-release），直接下载官方首页推荐的稳定发行版（Stable Releases）即可。

• Windows 用户：下载 Windows installer (64-bit)。
• macOS 用户：下载 macOS 64-bit universal2 installer。虽然 macOS 系统可能自带旧版 Python 工具，但安装官方独立版本能确保拥有现代的包管理器与干净的运行环境。

2. 启动安装向导与关键选项

在 Windows 下双击运行安装程序时，弹出的第一个界面至关重要。界面底部通常包含两个复选框：

1. Use admin privileges when installing py.exe（建议勾选，为所有用户提供启动便利）。
2. Add python.exe to PATH（必须勾选）。

二、验证安装结果：在终端中唤起解释器

安装向导提示“Setup was successful”后，需要立即通过系统的命令行工具验证安装结果。注意，此时必须打开一个全新的终端窗口，因为旧窗口无法感知刚才更新的环境变量。

1. 打开系统的命令行工具

• Windows：按下键盘组合键 Win + R，在弹出的“运行”对话框中输入 cmd 并回车，或在开始菜单中搜索打开“PowerShell” / “终端”。
• macOS：按下 Command + 空格键 唤起聚焦搜索（Spotlight），输入 Terminal（终端）并回车。

2. 执行版本查询命令

在终端的光标处键入以下命令并按下回车键：

python --version

在部分 macOS 或 Linux 系统中，系统别名可能将 Python 3 绑定在 python3 指令上。如果输入 python --version 提示找不到命令，可尝试键入：

python3 --version

三、运行 Python 的两种主要机制

确认命令可用后，我们需要理解 Python 的两种常见交互场景：交互式解释器（REPL） 与 脚本文件模式（Script）。初学者常把两者混淆，例如误在终端里直接写代码，或者在交互式环境中去执行文件。

1. 交互式解释器（REPL）

在终端中直接输入 python（或 python3）并回车，终端会进入带有三个大于号提示符 >>> 的环境。这就是 REPL（Read-Eval-Print Loop，读取-求值-打印循环）。

在 >>> 后面输入单行代码（如 1 + 1），回车即可立即看到计算结果。但请记住：在交互式环境中写的代码是临时的，一旦输入 exit() 回车退出，所有变量和代码都会在内存中销毁。因此，它只用于临时的语法试错和函数测试。

2. 脚本文件模式

要想编写可以长期保存、重复调用、修改维护的程序，必须使用脚本文件模式。做法是新建一个扩展名为 .py 的文本文件，将代码保存在文件中，然后在操作系统终端中用命令通知 Python 读取该文件并从头到尾执行。

四、编写你的第一个程序：创建与保存 hello.py

编写程序的第一步是选择合适的文本工具。切忌使用 Microsoft Word、WPS 或写字板等富文本编辑器，因为这类软件会在文档中隐式添加排版标记、字体样式和非纯文本编码，导致 Python 解释器无法读取。

初学者可以使用系统自带的“记事本”（Windows Notepad）或成熟的编程编辑器（如 Visual Studio Code、Sublime Text）。

1. 规划项目存放目录

在磁盘上建立一个结构清晰的工作文件夹，例如：

• Windows：D:\pycode 或 C:\pycode
• macOS：在用户主目录下建立 ~/pycode

尽量避免使用包含特殊符号、表情或深层空格的路径，这能极大降低命令行定位目录时的难度。

2. 编写代码并保存为 hello.py

打开编辑器，新建一个空白文档，输入以下一行完整代码：

print("Hello, World!")

3. 代码要素拆解

这行简短的代码由三个核心部分构成：

1. print：Python 内置的输出函数。它的作用是把括号内指定的内容传递给标准输出流，最终显示在终端屏幕上。注意 Python 对大小写严格敏感，必须写作全小写的 print，写成 Print 或 PRINT 均会引发报错。
2. 圆括号 ()：在编程中，圆括号紧跟在函数名后表示“调用函数”，括号内部放置传递给函数的具体内容（即实参）。必须使用英文半角输入法下的圆括号。
3. "Hello, World!"：被一对双引号包围的文字称为“字符串”。引号的作用是告诉解释器：这里面的内容是纯文本数据，请照原样输出，不要将其解读为代码指令。你可以使用成对的英文单引号 '...' 或双引号 "..."，但两端必须保持一致。

五、运行程序：从终端中执行 Python 脚本

代码保存好之后，不能用鼠标双击 hello.py 来运行。如果双击，Windows 会在后台拉起控制台并迅速执行完打印指令，由于程序执行完毕就会立刻退出，窗口会在零点几秒内一闪而过，导致你看不到任何输出。

正确的运行方式是：在已经打开的命令行终端中，主动发起调用。

1. 将终端当前工作目录切换到文件所在文件夹

打开命令行后，使用 cd（Change Directory）命令进入保存代码的文件夹。例如，如果代码存放在 D:\pycode：

d:
cd \pycode

如果是 macOS / Linux 环境，且代码保存在用户主目录下的 pycode 文件夹中：

cd ~/pycode

2. 执行运行指令

在当前目录下，键入启动命令并紧跟你的文件名：

python hello.py

当你看到屏幕上整齐打印出 Hello, World!，并且光标回到新的命令提示符等待下一次输入时，你的第一个 Python 程序就顺利完成了从编写到执行的完整闭环。

六、排查指南：初学者最常遇到的四类报错

在实际操作中，几乎每位初学者都会遇到一到两个报错。面对红色的报错信息，无需慌张，终端打印的错误提示实际上已经精确指出了问题所在。

七、总结与开发习惯建议

回顾整个过程，搭建 Python 编程环境并运行程序的本质是一套确定性的工具链协作：

• 解释器引擎：负责将你的文本指令翻译为机器可理解的字节码并执行（由安装包提供）。
• PATH 环境变量：让操作系统任何位置的终端都能通过“别名”快速调起解释器。
• 纯文本源代码：承载人类逻辑的文本文件，以 .py 结尾。
• 命令行终端：作为驱动程序运行、查看打印反馈和接收报错诊断的工作台。

建议在日常练习中，始终保持“编辑器负责写代码、命令行窗口负责跑代码”的清晰分工。在固定的工作目录下管理每一个代码文件，养成看懂终端报错提示的习惯。迈出这稳健的第一步后，后续学习变量、条件判断与循环结构时，便有了坚实可靠的运行底座。