Python零基础快速入门:环境搭建与第一个程序
面向零基础读者的Python实用入门指南。详细介绍Windows与macOS下的Python环境安装、PATH环境变量配置原理、交互式命令行体验、首个.py脚本编写与运行,以及新手高频报错的排查排错方法。
.py 为后缀的源码文件,通过命令行提交给解释器执行。本文以目前主流的 Python 3 稳定版为基准,逐步说明 Windows 与 macOS 平台的安装设置、环境验证、交互式 Shell 体验、首个脚本编写以及四类新手高频报错的具体排查方法。
一、认识 Python 解释器与系统调用链路
Python 是一门解释型语言。我们在代码编辑器中书写的代码,本质上只是普通的 UTF-8 编码文本字符,操作系统内核与计算机 CPU 无法直接识别这些英文字符。要让计算机执行代码中的逻辑,必须依赖一个名为 Python 解释器(官方默认实现为 CPython)的底层执行程序。
在终端中输入 python hello.py 时,操作系统需要完成三个动作:第一,根据命令名称在系统登记的目录中找到 python.exe(或 macOS 下的 python3)执行程序;第二,解释器启动并读取指定的文本脚本;第三,将语法解析为字节码后在虚拟机(PVM)中调度底层系统调用,最终把运行结果反馈在屏幕上。
如图 1 所示,官方安装包不仅会释放核心解释器,还会一并部署包管理工具 pip 以及标准库支持。而整个链路中最容易被初学者遗漏的环节,就是操作系统环境变量(PATH)的登记。如果缺少这一步,终端就无法感知 Python 的安装位置,从而引发最经典的“不是内部或外部命令”报错。
二、Windows 平台安装与核心选项设置
Windows 系统默认未预装 Python 开发环境。安装的核心目标不仅是将文件解压到磁盘,更重要的是让系统服务与控制台能够全局寻址。
1. 获取官方安装包
打开浏览器访问 Python 官方网站下载页面(python.org/downloads)。页面会自动识别当前操作系统并提供稳定版本的下载入口。对于 64 位 Windows 10/11 用户,下载标准的 Windows installer (64-bit) 可执行安装包(扩展名为 .exe)。
2. 运行安装程序与关键选项配置
双击下载完成的安装包,首屏界面是决定后续能否顺利运行的关键节点。请严格核对以下配置:
-
勾选 "Add python.exe to PATH"(极其关键):该复选框位于安装向导窗口的最底部。勾选此项后,安装程序会自动将 Python 主程序的目录及脚本目录(
Scripts)追加到当前系统或用户的 PATH 变量中,避免后续手动配置环境的繁琐操作。 - 勾选 "Use admin privileges when installing py.exe":允许安装器为系统注册启动器。
-
选择 "Customize installation"(自定义安装):点击进入自定义功能界面,确保
Documentation、pip、tcl/tk and IDLE、Python test suite均处于勾选状态,点击 "Next"。 -
指定无中文、无空格的安装路径:在 "Advanced Options" 界面中,勾选 "Install Python for all users"(按需),并将 "Customize install location" 修改为规整简洁的路径,例如
C:\Python312。避免将 Python 安装在含有中文、特殊符号或过深层级的目录下,可有效防止第三方库在构建本地 C 扩展时产生路径编码错误。
三、macOS 平台安装与终端路径核验
macOS 系统的环境组织与 Windows 略有不同。虽然现代 macOS 移除了过时的 Python 2,但在开发者工具(Xcode Command Line Tools)中可能附带特定版本的 stub。零基础读者应统一通过官方途径建立独立的 Python 3 运行时。
1. 官方 pkg 安装包安装
在官网下载页面选择针对 macOS 的 macOS 64-bit universal2 installer 安装包(.pkg 格式)。双击打开安装向导,按照默认步骤连续点击“继续”并同意许可协议,输入管理员密码完成安装。官方包会将 Python 3 安装至 /Library/Frameworks/Python.framework/Versions/3.x/,并在 /usr/local/bin 下自动创建软链接。
2. 运行 SSL 证书安装脚本
安装完成后,在“访达”中打开 Python 安装目录(或“应用程序”中的 Python 3.x 文件夹),双击运行名为 Install Certificates.command 的脚本文件。该脚本会自动为 Python 内置的网络请求模块配置根证书,确保后续使用 urllib 或通过 pip 下载资源时不会发生 SSL 证书校验失败的问题。
3. macOS 命令区分注意点
在 macOS 系统的终端(Terminal / iTerm2)中,为了避免与系统潜在的别名产生冲突,官方安装的命令通常默认命名为 python3 与 pip3。在执行所有命令行调用时,应优先使用带有版本后缀的明确指令。
四、验证环境就绪与交互式体验
完成安装后,必须通过命令行终端进行双向验收,确认操作系统已成功建立解释器寻址能力。
1. 版本指令校验
在 Windows 中按下快捷键 Win + R,输入 cmd 按回车打开命令提示符;在 macOS 中通过聚焦搜索打开“终端”。在命令行提示符后键入检查指令:
# Windows 系统输入: python --version # macOS 系统输入: python3 --version
紧接着验证包管理工具是否就位并指向同一 Python 安装源:
# Windows 系统输入: pip --version # macOS 系统输入: pip3 --version
2. 体验交互式命令行(REPL)
Python 提供了即时交互式环境(Read-Eval-Print Loop,简称 REPL)。在终端中直接输入 python(macOS 输入 python3)并回车,屏幕上会出现包含三个大于号(>>>)的提示符,表示解释器已准备好实时接收并运行单条指令:
>>> print("Hello, Python!")
Hello, Python!
>>> 20 + 26
46
>>> exit()
在交互式提示符后输入 exit() 并回车(或在 Windows 按 Ctrl + Z 后回车,macOS 按 Ctrl + D),即可退出交互环境并返回操作系统的常规命令行。
五、编写并运行第一个脚本文件(hello.py)
交互式 Shell 适合快速测试单行语法或验证表达式,但无法长期保存代码成果。日常开发必须将代码持久化编写为脚本文件。
1. 创建项目目录与源码文件
在电脑磁盘中建立一个结构清晰的工作目录(例如 Windows 下的 D:\Projects\py_learn 或 macOS 下的 ~/Projects/py_learn)。在该目录下新建一个名为 hello.py 的纯文本文件。
hello.py,其实际完整文件名可能是 hello.py.txt。请在资源管理器顶部菜单的“查看 - 显示”中勾选“文件扩展名”,确保后缀名严格为 .py。
2. 完整代码清单与语法拆解
使用纯文本编辑器(如 VS Code、Notepad++ 或系统自带的记事本)打开 hello.py,写入以下完整的标准代码:
# -*- coding: utf-8 -*-
# 第一个 Python 入门脚本:输出问候信息并进行简单计算
# 1. 定义变量存储文本数据
greeting_text = "Hello, World!"
learn_year = 2026
# 2. 调用内置 print 函数向标准输出打印内容
print(greeting_text)
print("Welcome to Python Programming in", learn_year)
关键代码细节解读:
#开头的行是注释。解释器在执行时会自动忽略注释内容,注释用于向开发者说明程序逻辑。greeting_text = "Hello, World!"是一个赋值语句。等号左侧是变量名,右侧是用半角双引号包裹的字符串。Python 属于动态类型语言,无需预先声明变量类型。print()是 Python 核心内置函数,负责将括号内的参数转换为文本流推送到控制台标准输出(stdout),并在末尾默认附带换行符。
3. 在终端中调用解释器执行脚本
打开终端,先使用 cd 命令切换到保存脚本的文件夹,然后向解释器传入文件名:
# 切换到工作目录 (示例路径) cd D:\Projects\py_learn # 提交执行指令 (macOS 使用 python3 hello.py) python hello.py
Welcome to Python Programming in 2026
屏幕上按顺序输出了两行文本,随后光标返回到常规命令行提示符。这证明 Python 解释器已经成功读取了磁盘文件、完成了语法分析并执行了所有内置函数,首个程序顺利运行。
六、零基础高频报错与精准排查指南
初学者在完成上述链路时,常常会遇到几类确定性的错误反馈。理解报错信息的结构并掌握对应的修复方案,是建立独立调试能力的第一步。
常见报错矩阵与应对方案
| 报错信息 (Error Signature) | 触发根因 (Root Cause) | 诊断与排查步骤 (Resolution) |
|---|---|---|
| 'python' 不是内部或外部命令 或 command not found: python |
系统环境变量 PATH 中缺少 Python 的可执行文件安装路径。 |
1. 重新打开安装程序选择“Modify”,补选“Add to PATH”; 2. 或在 Windows 系统属性中手动将 C:\Python312 与 C:\Python312\Scripts 追加到 Path 变量中;3. 务必重启终端生效。 |
| SyntaxError: invalid character in identifier | 代码中混入了中文全角标点符号(如中文字符串引号、中文括号或逗号)。 |
Python 语法解析器只接受 ASCII 半角符号。将中文的 “”、()、, 彻底切换为英文半角状态下的 ""、()、,。
|
| IndentationError: unexpected indent | 代码行首存在多余或未对齐的前导空格。 | Python 依靠行首缩进组织代码逻辑块。在当前尚未涉及循环或条件判断的顶层代码中,所有语句行首必须绝对顶格,清除所有无意敲击的空格或制表符。 |
| NameError: name 'Print' is not defined | 函数名拼写大小写不匹配。 |
Python 对标识符大小写极其敏感。print、input 等内置函数均为纯小写,将大写的 Print 或 PRINT 修改为全小写 print 即可。
|
| FileNotFoundError: [Errno 2] No such file or directory | 终端当前所在的工作目录与脚本实际存储目录不一致。 |
在终端输入 dir (Windows) 或 ls (macOS) 查看当前目录包含的文件。若未看到 hello.py,先使用 cd <实际路径> 正确切换至文件所在文件夹,或在执行命令时传入文件的完整绝对路径。
|
七、总结与后续学习路径
回顾从零开始的全部流程,可以清晰提炼为四个关键动作:
- 源头安装:从官网获取稳定版本,在安装步骤中完成系统 PATH 的自动登记;
- 双重验证:在重新打开的终端中分别执行版本查看与 REPL 交互命令,确保解释器与包管理工具双向可用;
- 文件落盘:规范命名以
.py结尾的源文件,并在编写语句时坚持使用英文半角字符与规范缩进; - 调用执行:通过终端进入文件所在目录,调用
python <脚本名>完成运行。
当终端稳定输出第一行 Hello, World! 且无任何报错时,本地开发运行底座便已彻底就绪。后续在此基础上,即可顺畅展开对基本数据类型、流程控制语句、函数定义与标准库模块的进一步学习。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









