Python零基础入门指南:从环境安装到运行第一个程序
学习编程不需要复杂的理论铺垫,最关键的第一步是在电脑上把开发环境正确建立起来,并亲眼看到第一行代码成功执行。本文将按照实际操作顺序,详细讲解从 Python 官方网站下载安装包、配置关键的环境变量选项、在系统命令行中验证安装结果,直到分别使用交互式解释器和独立脚本文件运行经典的“Hello World”程序,帮助你建立稳定可靠的编程起步环境。
一、下载与准备 Python 官方安装程序
要开始编写 Python 代码,首先需要在计算机上安装 Python 解释器。所谓解释器,就是一个负责把人类写下的 Python 代码翻译成计算机硬件能够执行的机器指令的软件程序。
获取 Python 的唯一推荐渠道是官方网站:python.org。进入官网后,将鼠标悬停在导航栏的 Downloads 菜单上,网页会自动检测你的操作系统(Windows、macOS 或 Linux),并提示对应的当前最新稳定版本安装包。
- Windows 用户:点击下载提供的 64 位安装程序(Windows installer, 64-bit),文件通常以
.exe结尾。 - macOS 用户:下载 macOS 64-bit universal2 installer,文件以
.pkg结尾。
二、安装向导配置:切勿遗漏 PATH 选项
双击下载好的安装文件后,会弹出安装配置向导界面。这一步是初学者遭遇问题最频繁的环节,核心在于界面的底部复选框。
在安装首页的底部,默认存在一个名为 "Add python.exe to PATH"(部分版本显示为 "Add Python 3.x to PATH")的勾选项。在默认情况下,该选项处于未勾选状态。
为什么这一步如此关键?操作系统在命令行执行命令时,会在系统的“PATH 环境变量”中依次查找该命令对应的可执行文件。如果不勾选此项,操作系统的命令行工具就不知道 python 命令到底安装在硬盘的哪个文件夹下。这直接导致后续在终端输入命令时报错:'python' 不是内部或外部命令,也不是可运行的程序。
勾选完成后,点击界面上的 Install Now 即可开始自动解压与配置。安装过程通常需要 1 到 2 分钟。安装结束后,若出现 "Disable path length limit"(禁用路径长度限制)的按钮,建议点击允许,以解除 Windows 默认的 260 字符文件路径限制。
三、验证环境是否安装成功
安装完成后,不要立即急于去寻找桌面图标(Python 解释器本身是命令行程序,不会在桌面上生成常规的图标)。正确的做法是通过系统终端进行可用性核验。
1. 打开操作系统的命令行工具
- Windows 系统:按下键盘快捷键
Win + R,在弹出的“运行”窗口中输入cmd并回车;或者在任务栏搜索框中输入cmd打开“命令提示符”或“PowerShell”。 - macOS 系统:按下
Command + 空格键打开聚焦搜索(Spotlight),输入Terminal或“终端”并回车。
2. 输入版本检测命令
在打开的黑底或白底命令行窗口中,光标闪烁处输入以下命令并按下回车键:
终端输入命令python --version
如果系统正确输出了安装的 Python 版本号,例如:
终端预期输出示例Python 3.12.3
这说明 Python 解释器已经成功安装,且环境变量配置完全有效。接着可以再输入一条命令,检查附带的包管理工具 pip:
终端输入命令pip --version
终端预期输出示例
pip 24.0 from C:\Users\Username\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)
python --version 提示找不到,或者显示为 2.7 系列,请尝试输入 python3 --version。在 macOS 上,新安装的 Python 默认命令名称通常为 python3。
四、运行你的第一个程序:两种常用方式
在 Python 中,运行代码主要有两种模式:交互式终端模式和脚本文件模式。两种方式各有其特定用途,作为零基础学习者,建议两种都亲自尝试一遍以理解它们的工作逻辑。
方式一:进入交互式解释器(REPL)即时执行
交互式解释器(Read-Eval-Print Loop)适合用来临时验证某行代码、测试某个函数或是计算数学表达式。
在刚才打开的命令行窗口中,直接输入 python 并回车(macOS 输入 python3):
python
此时命令行的提示符会发生变化,变成三个大于号 >>>。这表明你已经脱离了系统的命令外壳,直接进入了 Python 解释器的内部等待输入状态。
在 >>> 提示符后面键入第一行经典代码,注意括号和双引号必须在英文半角状态下输入:
print("Hello, World!")
按下回车键后,终端下一行会立刻打印出执行结果:
交互模式输出结果Hello, World!
想要退出交互式解释器返回普通系统命令行,可以输入 exit() 并回车,或者在 Windows 下按下 Ctrl + Z 回车,macOS 下按下 Ctrl + D。
方式二:编写独立的 .py 脚本文件并运行(正规开发方式)
交互式模式的缺点是窗口一旦关闭,输入的代码就会消失。在实际编程工作中,所有代码都会保存在以 .py 为后缀名的文本文件中。
按照以下具体步骤创建并运行你的第一个脚本文件:
- 准备项目文件夹:在电脑的非系统盘(例如 D 盘或 macOS 的个人目录下)新建一个名为
python_learn的英文文件夹。切记尽量不要在文件路径中使用中文或特殊空格。 - 新建文件:进入该文件夹,新建一个空白文本文档,重命名为
hello.py。特别提示(Windows 隐藏扩展名陷阱): Windows 系统默认会隐藏已知文件类型的扩展名。如果不小心,你新建的文件可能会被实际命名为hello.py.txt。请在 Windows 文件资源管理器顶部的“查看”菜单中,勾选“文件扩展名”,确保文件名确实是以.py结尾。 - 编写代码:右键点击
hello.py,使用任一文本编辑器打开(例如 VS Code、Notepad++ 或系统自带的“记事本”),输入以下内容并保存(快捷键Ctrl + S或Command + S):print("Hello, World!") print("这是我的第一个 Python 脚本程序。") - 通过终端定位并运行文件:打开命令行窗口,通过
cd(Change Directory)命令切换到保存脚本的文件夹。例如: 终端切换路径与执行命令
控制台输出结果cd D:\python_learn python hello.pyHello, World! 这是我的第一个 Python 脚本程序。
五、初学者常见报错与快速排查清单
在环境搭建和初次运行代码的过程中,遇到错误是非常正常的现象。绝大多数问题都属于以下几种典型情况,对照排查通常能在几分钟内解决:
| 报错信息 / 异常现象 | 根本原因分析 | 具体解决方法 |
|---|---|---|
'python' 不是内部或外部命令 |
安装时未勾选 Add python.exe to PATH,导致操作系统找不到主程序。 | 重新双击安装包,选择 Modify 或 Repair,补选 PATH 选项并完成更新;或者在系统高级设置中手动添加 Python 路径。 |
can't open file 'hello.py': [Errno 2] No such file or directory |
终端当前所在的工作目录与 hello.py 实际存储的文件夹不一致。 |
在终端中使用 cd 你的文件夹绝对路径 命令切换到文件实际所在的目录,或者将文件拖入终端获取路径。 |
SyntaxError: invalid character in identifier |
代码中的双引号、单引号或圆括号误输入为中文全角符号。 | 切换输入法为纯英文半角模式,重新输入代码中的 " " 和 ( )。 |
| 运行后终端毫无反应或直接闪退 | 双击了 .py 文件运行,程序执行完毕后窗口自动关闭。 |
不要直接双击 .py 文件;应先在系统内启动命令行终端窗口,再在终端中运行 python 文件名.py。 |
六、总结与下一步建议
通过本文的操作,你已经在计算机上建立了规范的 Python 运行环境,掌握了 PATH 环境变量的作用原理,并成功通过交互式终端与 .py 脚本文件执行了第一段程序。这是所有编程实践的基础起点。
在环境搭建完成后,建议不要继续使用系统记事本编写复杂的代码。接下来你可以选择并安装一款轻量且强大的专业代码编辑器(如 Visual Studio Code),安装对应的 Python 扩展插件。现代编辑器提供的高亮提示、自动格式化和内置终端,将进一步提升编写与调试代码的效率。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













