Python环境搭建教程:安装解释器并运行第一个程序

Ivy
Ivy
发布时间:2026-11-05 | 8人浏览过
原创

本教程详细讲解如何下载和安装Python官方解释器、配置系统环境变量,并通过终端命令行验证环境,最终分别通过交互式终端与脚本文件两种方式运行第一个Hello World程序。

Python环境搭建教程:安装解释器并运行第一个程序

要在计算机上运行 Python 代码,核心前提是安装 Python 解释器并将它注册到系统的环境变量中。本文面向零基础初学者,按照实际操作逻辑,完整讲解官方解释器的获取、安装向导的关键选项配置、命令行环境验证,并通过交互式解释器与独立脚本文件两种方式运行第一个经典程序。

一、理解核心对象:什么是 Python 解释器?

在开始安装之前,首先需要明确一个核心概念:我们平时常说的“编写 Python 程序”,实际上是在编写符合 Python 语法规则的纯文本文件(通常以 .py 为扩展名)。然而,计算机的中央处理器(CPU)只能直接理解二进制机器指令,无法直接读懂英文字符形式的 Python 代码。

Python 解释器 就是充当代码与计算机硬件之间翻译桥梁的专门软件。我们日常在官网下载的 Python,本质上就是官方标准解释器(CPython)。它内部包含两大部分:编译器前端负责将人类可读的源代码解析并转换成紧凑的平台无关中间代码(即字节码,Bytecode);虚拟机(Python Virtual Machine, PVM)则负责在当前操作系统上逐行读取并执行这些字节码。

Python环境搭建教程:安装解释器并运行第一个程序
图 1:Python 解释器内部执行流(源代码转换为字节码再由虚拟机执行输出)

与 C 或 C++ 等传统编译型语言不同,Python 开发不需要手动配置 Makefile、调用链接器生成单一二进制程序。只要你的操作系统中安装了 Python 解释器,任何一个文本文件只要符合语法,都可以直接交由解释器即时加载、编译并执行。

二、下载与安装 Python 解释器

搭建开发环境的第一步是从权威信源获取纯净、稳定的安装包。Python 是开源免费软件,所有官方安装文件均直接托管在 Python 基金会官方网站。

1. 官网下载安装包

使用浏览器访问官方网站 https://www.python.org,导航至 Downloads 菜单:

  • Windows 用户:页面通常会自动识别并推荐最新的稳定版(如 Python 3.12.x 或 3.13.x 64-bit installer)。直接点击下载对应的可执行安装包(.exe)。
  • macOS 用户:下载对应 macOS 架构的通用安装包(macOS 64-bit universal2 installer .pkg)。
版本选择依据
学习和新项目建议直接选择 Python 3 的最新长期稳定分支(Maintenance/Stable Status),避免选择带有 alpha 或 beta 标识的测试版本;同时切勿使用已停止支持的 Python 2.x 系列。

2. Windows 核心安装步骤(关键配置)

双击运行下载好的 python-3.x.x-amd64.exe。在弹出的首个安装界面中,包含初学者最关键的一步选择:

  1. 务必勾选底部选项:Add python.exe to PATH
    这是初学者最容易遗漏的步骤。默认情况下该选项处于未勾选状态。勾选后,安装程序会自动把 Python 的可执行文件目录以及 Scripts 脚本目录写入操作系统的系统环境变量中。若未勾选,系统在命令行中将无法识别 python 命令。
  2. 选择安装方式:
    • 点击 Install Now:使用向导默认配置快速安装到当前用户的主目录下,适合不想手动指定路径的新手。
    • 点击 Customize installation(推荐):保留默认勾选的 Documentation、pip、tcl/tk (IDLE) 和 Python test suite,点击 Next;在下一步勾选 Install Python 3.x for all users,并将安装路径简化为清晰短路径(例如 C:\Python312 或 C:\Program Files\Python312),避免路径中包含中文字符或深层嵌套。
  3. 点击 Install,等待进度条走完。在最后出现的“Setup was successful”界面中,如果提示“Disable path length limit”(解除 260 字符路径长度限制),建议点击该选项以确认解除,随后点击 Close 完成。
Python环境搭建教程:安装解释器并运行第一个程序
图 2:安装向导关键配置与 PATH 环境变量工作原理对比

3. macOS 系统安装说明

在 macOS 上双击下载的 .pkg 文件,按照向导一路点击“继续”并同意许可协议即可。macOS 会自动配置好系统路径映射,并在 Applications(应用程序)文件夹中生成 IDLE 以及配套的 Python 文件夹。需要注意的是,由于历史原因 macOS 系统中可能自带系统层级的兼容运行环境,日常推荐在终端使用明确的 python3 命令进行调用。

三、验证安装:确认解释器就绪

安装程序关闭后,不能仅凭界面关闭就断定环境已经就绪,必须通过系统终端执行命令,确认操作系统是否能准确加载解释器。

1. 打开终端工具

  • Windows 系统:按下键盘快捷键 Win + R,在弹出的运行窗口中输入 cmd 后按回车;或者按下 Win + X 选择打开“终端”(Windows Terminal / PowerShell)。
  • macOS 系统:按下快捷键 Command + 空格 呼出聚焦搜索(Spotlight),输入 Terminal 或“终端”并回车。

2. 输入版本查询命令

在终端的光标处键入以下命令并敲击回车:

命令输入 (Terminal / CMD)Bash/CMD
python --version
终端预期输出示例
Python 3.12.3

如果在 macOS 或部分 Linux 机器上输入 python --version 提示找不到命令,请改用:

macOS / Linux 显式调用Bash
python3 --version
终端预期输出示例
Python 3.12.3

只要终端准确回显了“Python 3.x.x”的版本号字样,就说明 Python 解释器已经成功安装,且环境变量配置完全有效。

排错提醒:如果看到“不是内部或外部命令”或“command not found”

发生该现象最常见的两个原因是:

  1. 终端未刷新:在安装 Python 之前就已经打开了该终端窗口。由于环境变量只在终端进程启动时加载一次,旧终端无法读取新变量。解决方法:关闭当前终端,重新打开一个新的终端窗口再次尝试。
  2. 未勾选 PATH:安装时遗漏了“Add python.exe to PATH”。解决方法:重新双击安装包,选择“Modify”,在后续界面确保勾选 PATH 相关选项完成修复,或通过系统高级属性手动添加 Python 安装路径至 PATH。

四、运行第一个程序:两种核心执行方式

计算机编程领域有着悠久的传统:用目标语言向屏幕打印一行字符串 Hello, World!。在 Python 中,我们有两种主要的执行手段:交互式解释器(REPL)与独立脚本文件模式。理解这两者的差异是后续编写复杂项目的基础。

Python环境搭建教程:安装解释器并运行第一个程序
图 3:交互式 REPL 与独立脚本文件执行方式的特征对比

方式一:进入交互式解释器(REPL 模式)

REPL 代表“读取-求值-输出-循环”(Read-Eval-Print Loop)。它允许我们输入一行代码,解释器立刻执行并返回结果。

操作步骤:

  1. 在终端中直接输入 python(macOS 键入 python3)并按回车。
  2. 终端将显示 Python 的版本信息,并将输入提示符切换为三个大于号:>>>。
  3. 在提示符后键入完整的输出语句:print("Hello, World!") 并按回车。
  4. 屏幕立即输出 Hello, World!。
  5. 要退出交互式环境返回系统命令行,输入 exit() 并按回车,或按下快捷键 Ctrl + Z 后回车(Windows)/ Ctrl + D(macOS)。
交互式会话完整示例Python Interactive Shell
> python
Python 3.12.3 (tags/v3.12.3:f6650f9, Apr  9 2024, 14:05:25) [MSC v.1938 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> print("Hello, World!")
Hello, World!
>>> 100 + 200
300
>>> exit()

适用场景:交互式模式非常适合临时验证某一条语法规则、查询库函数签名,或把它当作高精度计算器。但由于其关闭窗口后所有代码都不会保存到磁盘,因此无法用来构建正式的项目代码。

方式二:编写并运行独立脚本文件(.py 模式)

真正的程序开发是将代码保存在源文件中,以便反复修改、版本控制和自动化运行。

第一步:创建工作目录与代码文件

在计算机中挑选一个容易定位的目录(例如在 D 盘或用户目录创建 py_demo 文件夹)。打开任意纯文本编辑器(如系统自带的记事本 Notepad、VS Code、Sublime Text 等),新建一个文件并写入以下标准代码:

文件内容: hello.pyPython
# 第一个 Python 示例脚本
message = "Hello, World!"
print(message)

将该文件保存为 hello.py,保存类型务必选择“所有文件”,字符编码选择 UTF-8。

避坑提醒:警惕 Windows“隐藏已知文件扩展名”
Windows 默认隐藏扩展名,导致很多初学者将文件命名为 hello.py 后,实际真实全名变成了 hello.py.txt。运行命令时就会报错找不到文件。建议在文件资源管理器“查看”选项卡中,勾选“文件扩展名”以显示完整后缀。

第二步:在终端中定位并执行脚本

打开终端,首先使用目录跳转命令 cd 切换到保存 hello.py 的目录。例如如果保存在桌面或专用项目文件夹:

切换工作目录并执行Terminal / CMD
cd py_demo
python hello.py
终端预期输出结果
Hello, World!

当你在终端敲下 python hello.py 后,操作系统调用处于 PATH 中的 python.exe,Python 解释器以批处理模式打开 hello.py,自上而下逐行完成语法解析与执行,在终端屏幕打出欢迎语句,随后进程正常退出,控制权归还给操作系统。这标志着整个环境搭建与程序运行流程已彻底打通。

五、初学者常见报错与注意事项

初次接触代码时,极小的输入差异都可能导致报错。以下是搭建环境与运行第一个程序时最常见的几类问题及对应的直接排查措施:

错误表现 主要产生原因 针对性解决对策
SyntaxError: invalid character 使用了中文全角标点符号(如中文双引号 “” 或括号 ())。 切换为英文半角输入法,将所有标点替换为半角的 " 和 ()。
[Errno 2] No such file or directory 当前终端所处工作目录与目标 .py 文件所在磁盘路径不一致。 通过 cd 命令切换到文件所在目录,或在命令后书写完整绝对路径,例如 python "D:/demo/hello.py"。
在 >>> 提示符下键入 python hello.py 报错 初学者混淆了操作系统终端与 Python 交互式环境,在已经进入交互式解释器内部后又重复输入调用命令。 先键入 exit() 退出交互式解释器,退回到系统自带的 CMD/PowerShell 提示符下再执行运行命令。

六、全流程总结与速查清单

至此,你已经完成了 Python 环境搭建的全部核心工作。无论未来在 Windows、macOS 还是云端 Linux 服务器上部署应用,整个工作流遵循的底层机制都是一致的。

Python环境搭建教程:安装解释器并运行第一个程序
图 4:Python 环境搭建与程序运行速查工作流全景图

回顾整个流程,核心节点只有四个步骤:从官方信源获取安装包、在向导中勾选并将解释器注入系统 PATH、在命令行中借助版本参数完成连通性校验,以及根据需求选用交互模式或独立脚本模式运行逻辑。掌握了这些基础之后,后续就可以根据开发需求进一步配置 VS Code 或 PyCharm 等集成开发工具,开启更深入的开发实践。

本站声明

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

Python 相关产品和应用

全部下载

专题列表