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

宋时安
宋时安
发布时间:2026-10-22 | 9人浏览过
原创

学习编程不需要复杂的理论铺垫,最关键的第一步是在电脑上把开发环境正确建立起来,并亲眼看到第一行代码成功执行。本文将按照实际操作顺序,详细讲解从 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 结尾。
版本选择说明: 对于零基础学习者,直接选择官网首页推荐的最新稳定发行版(例如 Python 3.11 或 3.12 及以上)即可。无需刻意选择老旧版本,目前主流的 Python 第三方库均已全面适配主流的 Python 3 系列。
Python零基础入门指南:从环境安装到运行第一个程序
图 1:Python 基础环境从安装到首个程序运行的全流程路径

二、安装向导配置:切勿遗漏 PATH 选项

双击下载好的安装文件后,会弹出安装配置向导界面。这一步是初学者遭遇问题最频繁的环节,核心在于界面的底部复选框。

在安装首页的底部,默认存在一个名为 "Add python.exe to PATH"(部分版本显示为 "Add Python 3.x to PATH")的勾选项。在默认情况下,该选项处于未勾选状态。

重要注意事项: 在点击任何“下一步”或“Install Now”之前,必须首先手动勾选“Add python.exe 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)
macOS 读者的补充说明: macOS 系统自身可能自带较旧的 Python 2 或特定的运行库。如果你在 macOS 上输入 python --version 提示找不到,或者显示为 2.7 系列,请尝试输入 python3 --version。在 macOS 上,新安装的 Python 默认命令名称通常为 python3。
Python零基础入门指南:从环境安装到运行第一个程序
图 2:操作系统通过 PATH 变量定位并启动 Python 解释器的底层过程

四、运行你的第一个程序:两种常用方式

在 Python 中,运行代码主要有两种模式:交互式终端模式和脚本文件模式。两种方式各有其特定用途,作为零基础学习者,建议两种都亲自尝试一遍以理解它们的工作逻辑。

方式一:进入交互式解释器(REPL)即时执行

交互式解释器(Read-Eval-Print Loop)适合用来临时验证某行代码、测试某个函数或是计算数学表达式。

在刚才打开的命令行窗口中,直接输入 python 并回车(macOS 输入 python3):

终端输入命令
python

此时命令行的提示符会发生变化,变成三个大于号 >>>。这表明你已经脱离了系统的命令外壳,直接进入了 Python 解释器的内部等待输入状态。

在 >>> 提示符后面键入第一行经典代码,注意括号和双引号必须在英文半角状态下输入:

Python 交互模式下输入
print("Hello, World!")

按下回车键后,终端下一行会立刻打印出执行结果:

交互模式输出结果
Hello, World!

想要退出交互式解释器返回普通系统命令行,可以输入 exit() 并回车,或者在 Windows 下按下 Ctrl + Z 回车,macOS 下按下 Ctrl + D。

方式二:编写独立的 .py 脚本文件并运行(正规开发方式)

交互式模式的缺点是窗口一旦关闭,输入的代码就会消失。在实际编程工作中,所有代码都会保存在以 .py 为后缀名的文本文件中。

按照以下具体步骤创建并运行你的第一个脚本文件:

  1. 准备项目文件夹:在电脑的非系统盘(例如 D 盘或 macOS 的个人目录下)新建一个名为 python_learn 的英文文件夹。切记尽量不要在文件路径中使用中文或特殊空格。
  2. 新建文件:进入该文件夹,新建一个空白文本文档,重命名为 hello.py。
    特别提示(Windows 隐藏扩展名陷阱): Windows 系统默认会隐藏已知文件类型的扩展名。如果不小心,你新建的文件可能会被实际命名为 hello.py.txt。请在 Windows 文件资源管理器顶部的“查看”菜单中,勾选“文件扩展名”,确保文件名确实是以 .py 结尾。
  3. 编写代码:右键点击 hello.py,使用任一文本编辑器打开(例如 VS Code、Notepad++ 或系统自带的“记事本”),输入以下内容并保存(快捷键 Ctrl + S 或 Command + S):
    print("Hello, World!")
    print("这是我的第一个 Python 脚本程序。")
  4. 通过终端定位并运行文件:打开命令行窗口,通过 cd(Change Directory)命令切换到保存脚本的文件夹。例如: 终端切换路径与执行命令
    cd D:\python_learn
    python hello.py
    控制台输出结果
    Hello, World!
    这是我的第一个 Python 脚本程序。
Python零基础入门指南:从环境安装到运行第一个程序
图 3:交互式 REPL 与独立脚本文件运行方式的核心差异与场景对比

五、初学者常见报错与快速排查清单

在环境搭建和初次运行代码的过程中,遇到错误是非常正常的现象。绝大多数问题都属于以下几种典型情况,对照排查通常能在几分钟内解决:

报错信息 / 异常现象 根本原因分析 具体解决方法
'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零基础入门指南:从环境安装到运行第一个程序
图 4:Python 零基础入门环境配置与脚本运行关键检查清单

六、总结与下一步建议

通过本文的操作,你已经在计算机上建立了规范的 Python 运行环境,掌握了 PATH 环境变量的作用原理,并成功通过交互式终端与 .py 脚本文件执行了第一段程序。这是所有编程实践的基础起点。

在环境搭建完成后,建议不要继续使用系统记事本编写复杂的代码。接下来你可以选择并安装一款轻量且强大的专业代码编辑器(如 Visual Studio Code),安装对应的 Python 扩展插件。现代编辑器提供的高亮提示、自动格式化和内置终端,将进一步提升编写与调试代码的效率。

本站声明

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

Python 相关产品和应用

全部下载

专题列表