零基础学Python第一步:环境安装与Hello World编写指南
面向零基础读者的Python开发环境搭建与首个程序编写指南。详细讲解从官方安装包获取、Windows与macOS关键安装选项、PATH环境变量配置,到终端命令验证、交互式REPL使用及hello.py脚本编写与运行的完整流程,并提供新手高频报错的排查方法。
学习编程最直接的起点,是在自己的电脑上把运行工具安装正确,并亲手执行第一行代码。本文将指导你完成官方 Python 解释器的下载安装、说明环境变量 PATH 的核心设置,并通过命令行交互与独立代码文件两种方式,成功运行经典的“Hello World”程序,同时列出新手最常遇到的路径与标点错误排查方法。
一、准备工作:获取官方纯净安装包
Python 是一门解释型语言。编写好的代码本身只是普通的文本文件,需要通过名为“Python 解释器”的软件来读取并执行。因此,所谓“安装 Python”,本质就是在计算机上安装这个官方解释器程序。
获取安装包的唯一推荐途径是访问 Python 官方网站(python.org),避免从第三方下载站或软件管家获取可能包含捆绑插件或非标准路径的版本:
- 访问官网:在浏览器地址栏输入
https://www.python.org并回车。 - 进入下载区域:将鼠标悬停在顶部导航菜单的 Downloads 上,网站通常会自动识别你的操作系统,并直接展示对应的稳定版本(如 Python 3.12.x 或 3.13.x)下载按钮。
- 系统版本选择:Windows 用户通常选择 64 位安装程序(Windows installer 64-bit);macOS 用户下载匹配 macOS 系统的通用安装包(macOS 64-bit universal2 installer)。
二、关键安装步骤与 PATH 环境变量配置
安装过程非常直接,但有一个决定后续能否顺利使用命令行的关键选项必须正确勾选。
1. Windows 系统的安装操作
双击打开下载的 .exe 安装文件后,在弹出的初始安装界面中:
- 核心勾选项:在界面最底部,找到 “Add python.exe to PATH”(在部分版本中显示为 Add Python to environment variables)。务必勾选此项。
- 为什么必须勾选 PATH:PATH 是操作系统的全局环境变量。勾选后,系统会将 Python 安装目录登记到 PATH 列表中。这样无论你在命令行的哪个文件夹下输入
python,系统都能准确找到并调用它;如果不勾选,后续在命令行输入命令就会出现“不是内部或外部命令”的报错。 - 选择安装模式:点击界面的 “Install Now”(立即安装)。安装程序将自动展开文件,耗时约 1 至 2 分钟。
- 完成提示:界面显示 “Setup was successful” 即表示安装完成。若底部出现 “Disable path length limit”(禁用路径长度限制)选项,可以顺手点击一次并授权,避免后续安装第三方库时因文件路径过长而报错。随后点击 “Close” 关闭窗口。
如果你在安装时手快直接点击了安装而漏勾了“Add python.exe to PATH”,无需恐慌:只需重新双击运行刚下载的安装包文件,在弹出的窗口中选择 Modify(修改),连续点击 Next 进入高级选项(Advanced Options),勾选 “Add Python to environment variables”,再次点击 Install 完成更新即可。
2. macOS 系统的安装操作
双击下载的 .pkg 安装包,按照屏幕指引点击“继续”并同意许可协议,输入开机密码允许系统安装。安装完毕后,macOS 会自动配置好系统路径。注意:在 macOS 终端中,系统默认命令通常为 python3,以区别于系统历史内置的旧版本。
三、验证安装:在终端中确认 Python 可用
安装完成后,我们需要打开计算机自带的命令行终端工具,确认系统已经正确识别 Python 解释器。
1. 打开终端工具
- Windows:按下键盘组合键
Win + R,在运行窗口中输入powershell(或cmd)并按回车。 - macOS:按下组合键
Command + 空格打开聚焦搜索(Spotlight),输入Terminal并回车。
2. 执行版本检查命令
在打开的黑底或白底终端窗口中,键入以下命令并按下回车键(Windows 键入 python,macOS 推荐键入 python3):
python --version
预期返回示例:
Python 3.12.2
只要终端返回了带有版本号的字符串(例如 Python 3.12.x 或 3.13.x),就证明解释器已经成功就位,环境变量配置有效。
四、体验第一行代码:交互式 REPL 模式
Python 提供了两种运行方式:交互式终端模式与独立脚本模式。我们先体验最直接的交互模式。
在终端中直接键入 python(macOS 键入 python3)并按下回车,终端会打印出解释器版本与版权信息,最后出现三个大于号提示符 >>>。这表明你已经进入了 Python 的交互式编程环境(也称为 REPL:Read-Eval-Print Loop)。
>>> print("Hello, World!")
按下回车后,屏幕会立即在其下一行打印出执行结果:
Hello, World!
这是计算机对你发出的问候响应。交互式模式非常适合用于临时计算、验证一个函数的行为或测试简单的几行代码。要退出交互式环境返回操作系统的标准命令行,输入命令 exit() 并按回车即可。
五、编写并运行独立脚本:创建 hello.py 文件
交互式模式在关闭终端后,输入的代码就会消失。在实际开发中,我们总是把代码保存在文本文件中,以便反复修改、运行和共享。这些以 .py 为后缀名的文件被称为 Python 脚本。
1. 创建专用的代码文件夹
为了条理清晰,建议在电脑的常用位置(如桌面或用户主目录)新建一个名为 learn_python 的文件夹。这样可以避免文件散落在各处难以定位。
2. 新建脚本文件并编写代码
你可以使用系统自带的纯文本记事本,或者现代代码编辑器(如 Visual Studio Code):
- 在新建的
learn_python文件夹内,新建一个文本文件,并将其命名为hello.py。 - 用文本编辑器打开该文件,输入以下单行代码:
print("Hello, World!")
保存文件(快捷键 Ctrl + S 或 macOS 下 Command + S)并关闭编辑器。
Windows 系统默认会开启“隐藏已知文件类型的扩展名”选项。这容易导致初学者新建的实际文件名为 hello.py.txt,但桌面上仅显示为 hello.py。请在 Windows 文件资源管理器的顶部菜单点击“查看”→“显示”→勾选“文件扩展名”,确保文件名最后确确实实是 .py 而没有多余的 .txt。
3. 在终端中定位目录并执行脚本
要执行保存在硬盘上的脚本文件,终端必须知道文件存放在哪里。最稳妥的方式是使用 cd 命令切换到文件所在的文件夹:
# 示例:切换到你保存脚本的文件夹(以具体路径为准)
cd C:\Users\YourUsername\learn_python
# 执行该脚本
python hello.py
按下回车后,终端直接输出问候语:
Hello, World!
此时,Python 解释器在后台完成了三项工作:读取当前路径下的 hello.py 文本、将其编译为内存中的字节码、由虚拟机逐条解释执行并将字符串输出到控制台。这就是标准的程序运行全周期。
六、新手常见报错与排查清单
在首次编写与运行代码时,遇到报错是非常正常的现象。绝大多数初学者遭遇的阻碍都集中在以下四种情况:
| 错误表现 / 提示信息 | 主要原因剖析 | 对应解决步骤 |
|---|---|---|
| 'python' 不是内部或外部命令 或 command not found: python |
安装时漏选了“Add python.exe to PATH”,操作系统在当前系统路径中找不到可执行程序。 | 重新运行安装包,点击 Modify 并勾选 Add to PATH;或手动在“环境变量”的 Path 条目中添加 Python 所在安装目录。 |
| No such file or directory: 'hello.py' | 终端当前所在的“工作目录”并不包含 hello.py 文件,或者文件名实际为 hello.py.txt。 | 使用 cd 命令进入文件实际存放的目录;开启扩展名显示,确认文件名后缀为纯粹的 .py。 |
| SyntaxError: invalid character (语法错误:非法字符) |
代码中的引号 "" 或括号 () 误用了中文全角标点。 |
将输入法切换为纯英文半角状态,重新敲入代码中的双引号与圆括号。 |
| NameError: name 'Print' is not defined | Python 严格区分大小写,误将小写函数名 print 首字母大写写成了 Print。 |
修改代码,确保内置函数名 print 全部为英文小写字符。 |
七、总结
至此,你已经在计算机上搭建起了官方正版 Python 运行环境,掌握了 PATH 环境变量的核心作用,并成功掌握了在终端交互式环境与独立脚本中执行代码的方法。完成这些步骤意味着你的计算机已经具备了解析和执行 Python 程序的能力。接下来,你就可以在此环境中逐步探索变量、数据类型、条件分支以及循环等编程核心知识。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









