Python安装后怎么验证是否成功及运行Hello World

沈知远

发布时间：2026-11-12 | 3人浏览过

原创

详细讲解在Windows、macOS和Linux系统下如何验证Python是否正确安装，包括版本检查、交互式REPL执行以及首个hello.py脚本的创建与运行，并附带常见报错排查速查指南。

开发环境与基础实操

完成 Python 安装包的运行后，核心验证路径分为两步：首先通过操作系统自带的终端窗口，输入版本查询命令确认解释器与包管理器已注册到系统环境；随后分别通过“交互式终端（REPL）”和“独立脚本文件（.py）”两种方式打印输出经典字符 Hello, World!。本文将按具体操作步骤展开演示，并解析各环节的底层原理与常见报错成因。

Python安装后怎么验证是否成功及运行Hello World — 图 0：Python 环境验证与首个程序执行的核心三阶段总览

一、打开终端并验证 Python 是否正确就绪

Python 安装程序本质上是将解释器主程序（python.exe 或二进制文件 python3）以及标准库文件复制到系统磁盘的指定目录。验证安装是否成功的首要前提，是让操作系统的命令行解释程序能够找到并调用该程序。

1. 唤出系统命令行终端

不同操作系统打开命令行的方式如下：

Windows 系统：按下键盘快捷键 Win + R，在弹出的“运行”对话框中输入 cmd 或 powershell，按下回车键，即可打开命令提示符或 PowerShell 窗口。
macOS 系统：按下快捷键 Command + 空格键 调出聚焦搜索（Spotlight），输入“终端”或 Terminal 并回车。
Linux 系统：桌面环境下通常使用快捷键 Ctrl + Alt + T 打开终端。

2. 执行版本查询指令

在光标闪烁处输入以下命令并按下回车键。注意，不同操作系统及其安装配置在指令名称上略有差异：

# 通用指令（Windows 常规及配置了别名的环境）
python --version

# 针对 macOS 及绝大多数 Linux 发行版的推荐指令
python3 --version

# Windows 官方安装包特有的启动器指令（即使未勾选 PATH 也常可用）
py --version

预期正常输出示例：

[命令提示符回显]
Python 3.12.3

只要控制台输出了以 Python 3.x.x 开头的具体版本号，就说明操作系统已经成功在系统路径中检索到了 Python 可执行文件，安装与路径识别已经成功。

3. 同步验证 pip 包管理工具

pip 是 Python 官方的第三方包管理工具。在完成 Python 安装后，建议同步检测 pip 是否随同就绪，以便后续安装第三方功能库：

pip --version
# 若上一步使用 python3，对应此处也可使用：
pip3 --version

预期正常输出示例：

[命令提示符回显]
pip 24.0 from C:\Users\Username\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)

二、通过交互式命令行（REPL）运行 Hello World

验证 Python 正常就绪后，最快捷的 Hello World 实践方式是进入 Python 官方提供的交互式环境（即 REPL：Read-Eval-Print Loop，读取-求值-输出循环）。在该模式下，你输入的每一行代码都会被解释器实时计算并即刻返回结果。

1. 进入交互式环境

在刚才已成功显示版本号的终端中，直接输入 python（macOS/Linux 请输入 python3，Windows 亦可输入 py）并回车：

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.
>>>

请注意观察，光标前方的提示符从系统的路径提示变成了 >>>。这代表当前输入窗口已经交由 Python 解释器托管，接下来输入的每一句指令都必须是合法的 Python 语法，而不能再执行操作系统指令（如 dir、ls 等）。

2. 输入打印命令

在 >>> 提示符后，准确键入以下代码，然后敲击回车键：

>>> print("Hello, World!")

执行结果输出：

Hello, World!

代码细节拆解：

print() 是 Python 核心内置的输出函数；括号内的 "Hello, World!" 是一段用半角双引号括起来的字符串字面量。Python 接收到这行语句后，将字符串送入标准输出流（stdout），从而在屏幕上呈现纯文本。

3. 退出交互式环境

初学者常在执行完 REPL 后困惑如何返回系统控制台。退出交互模式的方式有两种：

输入退出函数：输入 exit() 或 quit()，然后回车。
键盘快捷键：Windows 环境下按下 Ctrl + Z 然后敲击回车；macOS 和 Linux 环境下直接按下 Ctrl + D 即可立即脱离解释器回到系统命令行。

三、编写并运行首个脚本文件（hello.py）

日常开发中的真实 Python 项目都是以纯文本文件（.py 扩展名）组织存储的。本节将指导读者在本地目录建立第一个物理代码文件，并通过终端命令调用解释器加载运行。

1. 新建代码文本文件

选择一个清晰易找的本地路径（例如在 Windows 桌面或用户主目录），使用任意纯文本编辑器（如 VS Code、Sublime Text，或操作系统自带的记事本/文本编辑），新建一个名为 hello.py 的文件。

避坑警告：防止扩展名被伪装成 hello.py.txt

Windows 系统在默认设置下会勾选“隐藏已知文件类型的扩展名”。很多初学者使用系统“记事本”新建文件并保存为 hello.py 时，其真实文件名其实是 hello.py.txt。如果在后续命令行中执行 python hello.py，系统就会报告文件不存在错误（No such file or directory）。
解决办法：在 Windows 资源管理器顶部工具栏点击“查看”菜单，勾选“文件扩展名”，确保文件名末尾是 .py 而非 .py.txt。

2. 在文件中写入代码并保存

打开 hello.py，在其中输入以下内容并保存（确保编码格式为 UTF-8）：

# 这是我的第一个 Python 脚本文件
print("Hello, World!")

3. 在终端中切换到文件所在目录

运行脚本时，必须让命令行终端处于该文件所在的文件夹下，或者使用绝对路径。通常推荐使用 cd（Change Directory）命令定位目录：

# Windows 示例（切换至桌面目录）
cd Desktop

# macOS / Linux 示例
cd ~/Desktop

可以使用 dir（Windows）或 ls（macOS/Linux）列出当前目录文件，确保能在列表中看到 hello.py。

4. 调用解释器执行脚本

在终端输入以下命令并回车：

# 标准命令格式：python 文件名.py
python hello.py

# 若在 macOS/Linux 上，请使用：
python3 hello.py

预期终端输出结果：

[终端执行结果]
Hello, World!

当终端屏幕直接输出了 Hello, World! 并自动返回到操作系统的常规提示符状态时，说明从源码文件编写、磁盘读取、解释器词法解析到标准输出打印的完整软件开发工作链全部验证通过。

四、初学者高频排障与报错原因速查

在实际验证与首次运行过程中，很多初学者会遇到命令不响应或报错中断的情况。这些问题通常源于环境路径缺失、命令提示符环境混淆或格式符号输入有误。以下列出最具代表性的四种情形及其解决方法。

报错现象 / 提示信息	核心原因剖析	具体纠正操作
`'python' 不是内部或外部命令，也不是可运行的程序`	安装 Python 时，未勾选“Add python.exe to PATH”，操作系统在全局搜索目录中找不到该命令。	重新打开 Python 安装安装包，选择 Modify 并在选项中勾选 Add to PATH；或在系统高级设置中手动添加 Python 安装路径至 Path 变量。
`can't open file 'hello.py': [Errno 2] No such file or directory`	当前命令行所在的目录与 `hello.py` 存放的物理目录不一致，或文件名被保存为 `hello.py.txt`。	使用 `cd` 命令导航至正确的文件夹，并在系统文件管理器中确认扩展名为单个 `.py`。
`SyntaxError: invalid character '“' (U+201C)`	在代码中输入了全角/中文双引号或中文括号，Python 词法分析器无法识别非 ASCII 标点。	将代码中的所有符号（如括号、引号）切换至英文输入法重新键入。
输入系统命令时提示 `SyntaxError: invalid syntax`	读者仍在 Python 交互式环境（`>>>`）中，却尝试输入 `python hello.py` 或 `cd` 等操作系统命令。	先输入 `exit()` 回车退出 Python 解释器，在系统的终端提示符（如 `C:\>` 或 `$`）下再执行系统指令。

五、结语

验证 Python 安装与运行 Hello World 是进入编程实践的基石。总结而言，只要终端能够正确识别 python --version，便证明操作系统的路径检索与解释器注册就绪；通过交互式 REPL 可以直接验证解释器的即时求值能力；而通过 python hello.py 则打通了从文本文件持久化到解释器加载执行的完整工作链。当这三层验证均顺利呈现期望输出后，本地计算机上的 Python 基础运行环境便已全部准备完毕，可以进一步进入语法学习或工程项目开发阶段。