Python零基础快速入门:环境搭建与第一个程序

栗子
栗子
发布时间:2026-11-06 | 7人浏览过
原创

面向零基础读者的Python实用入门指南。详细介绍Windows与macOS下的Python环境安装、PATH环境变量配置原理、交互式命令行体验、首个.py脚本编写与运行,以及新手高频报错的排查排错方法。

技术入门教程 // 基础设施准备
适用系统:Windows 10/11、macOS 基准环境:Python 3.12+ (CPython) 阅读耗时:约 8 分钟 操作目标:独立完成环境安装、环境变量配置与第一个脚本运行
Python零基础快速入门:环境搭建与第一个程序
图示:Python 核心运行链路概览(源码解析、环境变量桥接与终端标准流输出)
学习 Python 的起点并非复杂的算法或语法规则,而是建立一套稳固、可靠且可在终端随处调用的本地开发环境。核心任务由两个具体动作组成:首先从官方渠道下载安装 Python 解释器并正确写入系统环境变量;其次创建以 .py 为后缀的源码文件,通过命令行提交给解释器执行。本文以目前主流的 Python 3 稳定版为基准,逐步说明 Windows 与 macOS 平台的安装设置、环境验证、交互式 Shell 体验、首个脚本编写以及四类新手高频报错的具体排查方法。

一、认识 Python 解释器与系统调用链路

Python 是一门解释型语言。我们在代码编辑器中书写的代码,本质上只是普通的 UTF-8 编码文本字符,操作系统内核与计算机 CPU 无法直接识别这些英文字符。要让计算机执行代码中的逻辑,必须依赖一个名为 Python 解释器(官方默认实现为 CPython)的底层执行程序。

在终端中输入 python hello.py 时,操作系统需要完成三个动作:第一,根据命令名称在系统登记的目录中找到 python.exe(或 macOS 下的 python3)执行程序;第二,解释器启动并读取指定的文本脚本;第三,将语法解析为字节码后在虚拟机(PVM)中调度底层系统调用,最终把运行结果反馈在屏幕上。

Python零基础快速入门:环境搭建与第一个程序
图 1:Python 解释器安装与系统环境变量调用链路拓扑

如图 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 扩展时产生路径编码错误。
Python零基础快速入门:环境搭建与第一个程序
图 2:跨平台 Python 环境搭建标准化操作序列图
⚠️ 安装结束页的必要操作:解除路径长度限制
安装流程结束后,如果界面出现 "Disable path length limit"(解除 MAX_PATH 260 字符限制) 的选项,务必点击授权一次。在 Windows 操作系统中,若未解除该限制,当后续安装层级嵌套较深的复杂第三方依赖包时,可能会因路径超过 260 个字符而中断报错。

三、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。在执行所有命令行调用时,应优先使用带有版本后缀的明确指令。

四、验证环境就绪与交互式体验

完成安装后,必须通过命令行终端进行双向验收,确认操作系统已成功建立解释器寻址能力。

💡 终端重启规则
如果在运行安装程序之前已经打开了 CMD 或 PowerShell,请先完整关闭当前终端窗口,重新打开一个新的终端。因为已有终端进程缓存了启动时的旧环境变量快照,只有新启动的终端才能读取刚写入注册表的 PATH 变量。

1. 版本指令校验

在 Windows 中按下快捷键 Win + R,输入 cmd 按回车打开命令提示符;在 macOS 中通过聚焦搜索打开“终端”。在命令行提示符后键入检查指令:

TERMINAL COMMAND BASH / CMD
# Windows 系统输入:
python --version

# macOS 系统输入:
python3 --version
预期输出示例 (EXPECTED OUTPUT)
Python 3.12.3

紧接着验证包管理工具是否就位并指向同一 Python 安装源:

TERMINAL COMMAND BASH / CMD
# Windows 系统输入:
pip --version

# macOS 系统输入:
pip3 --version
预期输出示例 (EXPECTED OUTPUT)
pip 24.0 from C:\Python312\Lib\site-packages\pip (python 3.12)

2. 体验交互式命令行(REPL)

Python 提供了即时交互式环境(Read-Eval-Print Loop,简称 REPL)。在终端中直接输入 python(macOS 输入 python3)并回车,屏幕上会出现包含三个大于号(>>>)的提示符,表示解释器已准备好实时接收并运行单条指令:

PYTHON REPL INTERACTION INTERACTIVE SHELL
>>> print("Hello, Python!")
Hello, Python!
>>> 20 + 26
46
>>> exit()

在交互式提示符后输入 exit() 并回车(或在 Windows 按 Ctrl + Z 后回车,macOS 按 Ctrl + D),即可退出交互环境并返回操作系统的常规命令行。

Python零基础快速入门:环境搭建与第一个程序
图 3:Python 解释型程序执行机制与内存运行时架构

五、编写并运行第一个脚本文件(hello.py)

交互式 Shell 适合快速测试单行语法或验证表达式,但无法长期保存代码成果。日常开发必须将代码持久化编写为脚本文件。

1. 创建项目目录与源码文件

在电脑磁盘中建立一个结构清晰的工作目录(例如 Windows 下的 D:\Projects\py_learn 或 macOS 下的 ~/Projects/py_learn)。在该目录下新建一个名为 hello.py 的纯文本文件。

⚠️ Windows 用户注意扩展名陷阱
Windows 资源管理器默认勾选了“隐藏已知文件类型的扩展名”。如果新建了“文本文档”并重命名为 hello.py,其实际完整文件名可能是 hello.py.txt。请在资源管理器顶部菜单的“查看 - 显示”中勾选“文件扩展名”,确保后缀名严格为 .py。

2. 完整代码清单与语法拆解

使用纯文本编辑器(如 VS Code、Notepad++ 或系统自带的记事本)打开 hello.py,写入以下完整的标准代码:

PYTHON SCRIPT 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 命令切换到保存脚本的文件夹,然后向解释器传入文件名:

TERMINAL EXECUTION BASH / CMD
# 切换到工作目录 (示例路径)
cd D:\Projects\py_learn

# 提交执行指令 (macOS 使用 python3 hello.py)
python hello.py
终端运行结果 (STDOUT RESULT)
Hello, World!
Welcome to Python Programming in 2026

屏幕上按顺序输出了两行文本,随后光标返回到常规命令行提示符。这证明 Python 解释器已经成功读取了磁盘文件、完成了语法分析并执行了所有内置函数,首个程序顺利运行。

六、零基础高频报错与精准排查指南

初学者在完成上述链路时,常常会遇到几类确定性的错误反馈。理解报错信息的结构并掌握对应的修复方案,是建立独立调试能力的第一步。

Python零基础快速入门:环境搭建与第一个程序
图 4:首个 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 <实际路径> 正确切换至文件所在文件夹,或在执行命令时传入文件的完整绝对路径。

七、总结与后续学习路径

回顾从零开始的全部流程,可以清晰提炼为四个关键动作:

  1. 源头安装:从官网获取稳定版本,在安装步骤中完成系统 PATH 的自动登记;
  2. 双重验证:在重新打开的终端中分别执行版本查看与 REPL 交互命令,确保解释器与包管理工具双向可用;
  3. 文件落盘:规范命名以 .py 结尾的源文件,并在编写语句时坚持使用英文半角字符与规范缩进;
  4. 调用执行:通过终端进入文件所在目录,调用 python <脚本名> 完成运行。

当终端稳定输出第一行 Hello, World! 且无任何报错时,本地开发运行底座便已彻底就绪。后续在此基础上,即可顺畅展开对基本数据类型、流程控制语句、函数定义与标准库模块的进一步学习。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表