Python零基础入门:环境搭建与运行第一个程序
面向零基础读者的Python开发环境搭建与程序运行指南,涵盖Windows与macOS下载安装、PATH环境变量配置、交互式终端与代码脚本两种运行方式的区别,以及常见新手报错排查。
python 命令。本文面向零基础读者,完整演示 Windows 与 macOS 平台下的规范安装流程、终端可用性验证,并通过交互式解释器与独立脚本文件两种方式运行经典的“Hello, World!”程序,深入剖析两者的运作机制差异与初学者最常遇到的四类环境问题。
一、准备工作与解释器获取
计算机本身无法直接理解人类编写的 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 关闭向导即可。
C:/Python312 而非 D:\我的软件\Python 3.12),以防止未来某些第三方库在编译或寻址时引发编码异常。
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 --version 可能会提示未找到,或者显示 2.x 版本。此时请输入 python3 --version。若 python3 能正确输出版本号,则后续所有操作均以 python3 代替 python 即可。
四、运行第一个程序:两种核心方式的对比与实践
运行 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 的纯文本文件中。
- 创建代码文件:在电脑中挑选一个目录(例如
D:/python_study或 macOS 的用户目录),新建一个名为hello.py的纯文本文件。推荐使用 VS Code 等代码编辑器打开该文件。 - 写入并保存代码:在
hello.py中写入单行打印语句并保存文件:hello.py 源码Pythonprint("Hello, World!")
- 在终端中调度执行:打开系统命令行终端,先使用
cd命令切换至该文件所在文件夹,然后调用 Python 解释器执行该脚本:终端操作命令Terminal / CMD# 1. 切换至文件所在文件夹 (示例路径) cd D:/python_study # 2. 调用解释器执行 hello.py python hello.py
执行后,终端会打印出对应的结果并直接退出 Python 进程,将终端控制权归还给操作系统:
Hello, World!
关键差异分析:为什么这两种方式都必不可少?
初学者常常困惑:既然可以用一行命令直接打印,为什么还要大费周章创建文件?两者在机制与用途上有明确的分野:
| 对比维度 | 交互式解释器(REPL 模式) | 脚本文件模式(.py 文件) |
|---|---|---|
| 代码生命周期 | 即时求值后仅驻留内存,会话关闭后全部丢弃 | 以纯文本形式持久化保存在磁盘中,可随时复现 |
| 执行粒度 | 单行或单一逻辑块即时响应 | 解释器通读整个文件,按代码结构和流程控制完整执行 |
| 调试与复用 | 修改历史代码繁琐,无法作为独立软件发布 | 支持版本管理、模块拆分、函数定义与长期维护 |
| 典型使用场景 | 临时充当高级计算器、测试函数返回值、验证基础语法 | 编写自动化工具、网页后端服务、数据分析工程 |
核心差异的影响:交互式环境让学习者免去文件管理的开销,能够在几秒钟内验证一段语法是否正确;而脚本文件则是工业软件的基石。在日后的学习中,我们通常在交互式终端中快速“探索”,在脚本文件中完成“构建”。
五、新手初次运行常见报错与排查决策
在搭建环境与运行第一个程序的过程中,极少数人能一次不错。以下四类问题覆盖了绝大多数新手所遭遇的瓶颈,按图索骥即可快速定位与解决。
1. 报错:“'python' 不是内部或外部命令,也不是可运行的程序”
原因剖析:操作系统的命令行在接到 python 命令后,会在全局环境变量 PATH 所记录的所有文件夹中逐一搜索 python.exe。若搜索完毕仍未找到,便会抛出此错误。这说明安装时未勾选“Add python.exe to PATH”,或者安装完成后没有重启已打开的终端。
解决方法:
- 重新运行最初下载的 Python 安装程序;
- 在弹出的界面中点击 Modify(修改),勾选 Add python.exe to PATH,然后一路点击 Next 完成修复;
- 彻底关闭当前已经打开的所有 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。
解决方法:
- 打开 Windows 文件资源管理器,点击顶部的“查看”菜单(Windows 11 点击“查看” -> “显示”);
- 勾选“文件扩展名”;
- 此时回到文件列表,会发现原本的
hello.py显露出了全名hello.py.txt。右键选择重命名,将末尾多余的.txt删掉并确认更改即可。
六、全文总结
完成 Python 环境搭建并打印出第一行“Hello, World!”,标志着计算机系统已经能够正确调度 Python 解释器。回顾整个过程,核心在于把握三个关键环节:
- 系统层:通过环境变量 PATH 建立系统命令行与解释器可执行文件之间的寻址通路;
- 实践层:理清即时探索(REPL 交互)与工程编码(.py 脚本文件)各自的适用边界与机制差异;
- 排障层:面对命令行无响应、字符编码、语法标点与工作路径不符等基础异常,能够结合错误回显精准定位于特定环节。
环境就绪后,接下来即可安装专用的代码编辑器(如 Visual Studio Code),开始系统学习变量、数据类型与流程控制等核心语法。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













