零基础Python入门:从安装环境到运行第一个程序

星野
星野
发布时间:2026-11-13 | 4人浏览过
原创

零基础Python入门实用指南:从官方安装包获取、环境变量PATH设置、终端验证,到编写并运行第一个hello.py脚本,提供清晰步骤、原理对比与避坑排查。

Python 新手实操教程
搭建 Python 开发环境的核心任务只有两件:让操作系统能够随时调用 Python 解释器,以及让解释器读取并执行我们写好的代码文件。本文将按照实际操作顺序,详细讲解官方环境下载、Windows 与 macOS 上的安装关键选项、命令行验证,以及第一个代码文件的编写与运行,帮助初学者跨过入门阶段最容易遇到的环境与路径障碍。
零基础Python入门:从安装环境到运行第一个程序
图 1:Python 新手环境搭建与首个程序执行概览

一、明确目标:从零开始需要准备什么

很多零基础读者在尝试学习编程时,容易被“IDE(集成开发环境)”、“虚拟环境”、“依赖管理”等繁杂概念劝退。实际上,运行 Python 程序的最简闭环只需要三样基础工具:

  • Python 解释器:负责将人类可读的 Python 代码翻译成计算机底层指令的核心软件。我们直接从 Python 官方网站下载安装。
  • 纯文本编辑器:用来编写代码的工具。初始阶段可以使用系统自带的记事本、TextEdit,也可以使用轻量级代码编辑器(如 VS Code、Sublime Text 或 Notepad++)。切记不要使用 Word 或富文本软件,因为它们会在文件中掺杂不可见的排版标记。
  • 系统终端(命令行):Windows 上的“命令提示符(CMD)”或“PowerShell”,macOS 上的“终端(Terminal)”。我们将通过终端向系统下达运行指令。

理清这三者的角色之后,整个安装与运行流程就变得非常直接清晰:下载并安装解释器 → 验证终端能找到该解释器 → 编写一个扩展名为 .py 的纯文本文件 → 在终端调用解释器运行它。

零基础Python入门:从安装环境到运行第一个程序
图 2:零基础配置 Python 环境与运行首个程序的四个核心阶段

二、下载与安装 Python 解释器

获取安装包的唯一推荐途径是前往官方网站(https://www.python.org),避免通过第三方软件下载站获取被植入插件或修改过默认配置的安装包。

1. Windows 系统的安装细节(重中之重)

进入官网的 Downloads 导航栏,网页通常会自动识别 Windows 系统并提供当前最新的稳定版(如 Python 3.12.x 或 3.11.x)安装器。双击下载好的 .exe 文件进入安装向导界面。

必须注意的勾选项目:Add python.exe to PATH
在向导的第一个欢迎界面最下方,有一个名为 “Add python.exe to PATH” 的复选框(部分版本写作 “Add Python to environment variables”)。安装包默认可能不会勾选此项,请务必手动勾选它!勾选后,再点击上方的 “Install Now” 即可。

如果遗漏了这一步,Python 会被安装在用户的深层隐藏目录中,操作系统无法通过终端自动定位到它,从而导致后续执行命令时出现“不是内部或外部命令”的经典报错。

2. macOS 系统的安装要点

在官网下载适用于 macOS 的通用安装包(macOS 64-bit universal2 installer),格式为 .pkg。双击按向导提示点击“继续”即可完成安装。macOS 的安装程序会自动将可执行文件加入到环境变量中,并在应用程序目录生成“Python 3.x”文件夹。

零基础Python入门:从安装环境到运行第一个程序
图 3:环境变量 PATH 寻址机制与勾选前后的行为差异对比

三、深层理解:为什么 PATH 环境变量如此重要

许多初学者往往机械地按照教程“勾选 PATH”,却不理解这个操作的实质。了解这一原理,能够帮助你在未来面对各种开发工具配置时具备基本的排查能力。

在操作系统中,每一个命令(如 dir、cd、python)本质上都是一个具体的可执行程序。当你在终端输入 python 时,操作系统需要知道去硬盘的哪个角落寻找这个程序:

  1. 未配置 PATH 时:操作系统只会在当前终端打开的那个文件夹里寻找 python.exe。由于终端默认打开的是用户主目录,里面显然没有安装好的 Python 主程序,系统就会放弃查找并抛出错误。
  2. 已配置 PATH 时:系统环境变量中的 PATH 是一个路径列表。系统在当前目录找不到目标时,会沿着列表中登记的所有文件夹逐一搜索。当我们在安装时勾选了该项,安装包就会把 Python 的安装目录(例如在 Windows 下注册到全局环境)追加到该列表中,从而实现全局随时随地调用。

四、验证环境:在终端中唤醒 Python

安装完成后,我们需要检验环境是否就绪。请勿直接双击桌面或开始菜单里的图标,而是学会使用终端命令进行验证。

1. 打开终端

  • Windows:按下快捷键 Win + R,在弹出的“运行”窗口输入 cmd,回车;或者在任务栏搜索框输入“命令提示符”或“PowerShell”打开。
  • macOS:按下快捷键 Command + 空格 唤出聚焦搜索,输入 Terminal 或“终端”,回车。

2. 运行版本检测命令

在打开的终端黑白界面光标处,键入以下命令并按下回车:

输入命令
python --version
示例回显 Python 3.12.2

注:在 macOS 或某些 Linux 系统中,如果输入 python --version 提示找不到或显示旧版本 2.7,请尝试输入 python3 --version。因为系统默认的 python 别名可能指向历史版本,而新安装的均以 python3 命名。

3. 初识交互式环境(REPL)

若直接输入 python(或 python3)并回车,终端会进入交互式解释器,此时命令提示符会变为三个右尖括号 >>>:

交互式模式示例
>>> print("Hello from REPL")
Hello from REPL
>>> 1 + 1
2

在这个模式下,每输入一行代码按回车,Python 就会立即执行并输出结果。要退出该模式返回系统终端,可以输入 exit() 并回车,或在 Windows 下按 Ctrl + Z 回车,macOS 下按 Ctrl + D。

零基础Python入门:从安装环境到运行第一个程序
图 4:Python 脚本从源文件读取、语法解析到标准输出打印的执行全流程

五、编写并运行第一个 Python 独立程序

虽然交互式命令行非常适合测试单行逻辑,但在实际开发中,我们都会把代码写在文件中保存起来,交由 Python 一次性执行。接下来我们完整创建并执行属于你的第一个代码文件。

步骤 1:新建一个专用的练习目录

建议养成规范管理代码文件的习惯。例如在电脑的 D 盘或用户文稿目录下新建一个名为 py_study 的文件夹,不要把代码文件直接散落在桌面或系统根目录。

步骤 2:创建源代码文件 hello.py

打开你的纯文本编辑器(以基础记事本为例),在新建的空白文档中输入以下单行代码:

Python 源代码
# 第一个 Python 程序:向世界问好
print("Hello, World!")

代码解释:

  • print() 是 Python 的内置输出函数,作用是将括号中的内容输出展示在终端屏幕上。
  • 双引号 "..." 表示其包裹的内容是一段纯文本(在编程中称为“字符串”)。
  • # 开头的部分是代码注释,解释器在执行时会自动忽略它,主要用于给人类阅读说明。

在保存文件时,文件名填写为 hello.py,保存类型选择“所有文件 (*.*)”,编码格式选择 UTF-8。确保保存后的文件完整名称为 hello.py,而不是由于系统隐藏后缀名导致的 hello.py.txt。

步骤 3:在终端中导航并运行该脚本

打开终端,首先使用 cd(Change Directory)命令进入到存放文件的文件夹。例如你的文件夹位于 D:\py_study:

终端操作命令
# Windows 跨盘符切换先输入盘符,再切换文件夹:
d:
cd py_study

# 调用 Python 解释器执行脚本文件:
python hello.py
终端实际回显结果 Hello, World!

当看到终端准确输出了这一行文字并平静地退回命令提示符状态时,说明你的第一个 Python 程序已经顺利完成全流程执行!

零基础Python入门:从安装环境到运行第一个程序
图 5:初学者高频运行报错的三叉排查法与通关检查单

六、新手常见报错与避坑指南

初学编程时遇到报错是极其正常的现象。计算机会忠实地指出哪里遇到了阻碍。以下是第一次运行程序时最容易出现的三类报错及其针对性解决方法:

报错提示片段 根本原因分析 具体解决操作
'python' 不是内部或外部命令 或 command not found 安装时未勾选 PATH 环境变量,或添加变量后未重新打开终端。 ① 关闭当前终端窗口重新打开;② 若仍报错,重新运行官方安装包选择 Modify,补勾“Add to PATH”后完成修复。
SyntaxError: invalid character 或 invalid syntax 在代码中误输入了中文全角符号,例如中文引号(“”)或中文圆括号(())。 切换到英文半角输入法,将代码中的括号与引号重新键入一遍;另外确认 print 均为小写。
FileNotFoundError: [Errno 2] No such file 当前终端的工作目录并不是 hello.py 所在的位置,或者文件名包含了隐藏的 .txt 后缀。 ① 在终端先输入 dir(Windows)或 ls(macOS)查看当前目录下是否有该文件;② 确认使用 cd 命令移动至正确的目录。
总结:稳步推进学习的后续建议

完成上述步骤后,你的计算机已经具备了执行任何标准 Python 代码的基础运行环境。接下来你可以尝试:

  • 在代码中尝试多行 print(),打印不同的数字、文字与数学计算(如 print(2026 + 1))。
  • 安装一款现代代码编辑器(如 Visual Studio Code),利用其语法高亮、自动补全与内置终端功能,提高编写和调试的舒适度。
  • 始终牢记代码执行的因果逻辑:编辑文件保存 → 终端定位路径 → 指明解释器执行。理解了底层链路,后续学习变量、函数与模块便能得心应手。

本站声明

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

Python 相关产品和应用

全部下载

专题列表