Python安装后怎么验证成功并运行第一个Hello World程序

蓝鲸
蓝鲸
发布时间:2026-11-10| 8人浏览过
原创

详细介绍Python安装完成后如何通过命令行终端验证安装成功、排查PATH环境变量问题,并在交互式REPL与独立脚本文件中运行第一个Hello World程序。

Python 基础起步教程

完成 Python 的安装后,验证其是否可用包含两个明确动作:首先在操作系统终端中通过版本查询命令确认 Python 已正确安装并写入系统路径,随后通过交互式终端与独立脚本文件两种方式运行输出“Hello, World!”。本文将按实际操作次序梳理具体的验证指令、预期结果以及排查常见异常的关键细节。

Python安装后怎么验证成功并运行第一个Hello World程序
图 0:Python 安装后两阶段核心验证全景流程

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

安装程序运行完毕后,桌面通常不会自动生成像普通办公软件那样的快捷图标。Python 主要通过命令行界面或集成开发环境(IDE)来驱动。验证的第一步,是打开操作系统自带的命令行终端:

  • Windows 系统:按下键盘上的 Win + R 快捷键打开运行窗口,输入 cmd 或 powershell 并回车;也可以在任务栏开始菜单搜索栏中直接输入“命令提示符”或“终端”。
  • macOS 系统:按下 Command + 空格键 调出聚焦搜索(Spotlight),输入 Terminal 或“终端”并回车。
  • Linux 系统:可以使用快捷键 Ctrl + Alt + T 快速调出终端窗口。

打开终端后,在光标闪烁处输入以下版本检测命令,并按下回车键:

python --version

在某些操作系统(如 macOS 或部分 Linux 发行版)中,系统可能同时预装或区分了 Python 2 与 Python 3 的命令。若输入上述命令提示未找到,请尝试运行带版本标识的指令:

python3 --version
终端示例输出(出现具体版本号即表示安装并识别成功): Python 3.12.3

只要终端输出了类似 Python 3.x.x 的具体版本编号,就说明 Python 的主程序文件已经存在,并且当前命令行环境能够正确找到并加载它。

Python安装后怎么验证成功并运行第一个Hello World程序
图 1:终端环境验证操作顺序与各节点状态确认

二、遇到命令报错时的排查与 PATH 环境变量修复

如果输入 python --version 后,终端出现如下提示之一:

  • 'python' 不是内部或外部命令,也不是可运行的程序或批处理文件。(Windows CMD)
  • zsh: command not found: python(macOS 终端)
  • 自动弹出了微软商店(Microsoft Store)的下载页面(Windows 系统的应用执行别名机制所致)

这并不意味着安装文件已损坏,核心原因是:操作系统的全局环境变量(PATH)中没有记录 Python 主程序的存放文件夹路径。

操作系统在终端中接收到一个未指定绝对路径的命令时,会依次查找系统 PATH 列表中配置的各个目录。如果在这些目录下都没有找到 python.exe,系统就会直接抛出“找不到命令”的提示。

Python安装后怎么验证成功并运行第一个Hello World程序
图 2:终端指令定位可执行文件与 PATH 环境变量的工作机制
修复方法:
  1. 重新运行安装包勾选自动添加:最省力的方式是重新打开 Python 安装包(.exe 文件),选择 Modify(修改)或重新安装,在初始界面的最底部务必勾选 “Add python.exe to PATH”,完成后点击 Install。
  2. 关闭 Windows 应用执行别名干扰:若输入 python 后总是弹出应用商店,进入 Windows 设置 -> 应用程序 -> 高级应用设置 -> “应用执行别名”,将列表中的“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”切换为关闭状态。
  3. 重开终端生效:更改环境变量后,已打开的旧终端窗口不会自动同步,必须关闭现有的终端窗口并重新打开一个新的终端。

三、在交互式环境(REPL)中运行第一个 Hello World

确认版本无误后,即可执行第一行 Python 代码。Python 内置了交互式解释器(常称 REPL:Read-Eval-Print Loop,即读取-求值-打印循环),它允许我们在输入一行代码后立即得到计算或输出结果。

1. 进入交互式环境

在终端中直接输入 python(或 python3)并回车:

python

此时控制台会输出几行 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.
>>>

2. 输入并执行 print 语句

在 >>> 提示符后面输入以下代码(注意:双引号与括号必须为标准的英文字符,不要输入成中文全角标点):

print("Hello, World!")

按下回车键后,终端下一行会立刻打印出双引号内部的内容:

预期执行结果: Hello, World!

3. 退出交互式环境

交互式环境适合临时测试单行代码或查看函数功能。完成测试后,需要退出该环境返回普通的系统终端状态。退出方式如下:

  • 输入退出函数:exit() 或 quit(),然后按回车。
  • 快捷键退出:Windows 系统下按下 Ctrl + Z 后回车;macOS 与 Linux 系统下直接按下 Ctrl + D。
Python安装后怎么验证成功并运行第一个Hello World程序
图 3:交互模式即时响应与脚本文件持久化执行的定位差异

四、编写并运行独立的 Python 脚本文件

在真实的开发过程中,程序必须保存在文件里。将代码写成以 .py 为后缀名的脚本文件,由 Python 解释器读取并批量运行,是更通用的使用方式。

1. 新建并编写脚本文件

  1. 在电脑中选择一个易于查找的文件夹(例如在 D 盘或桌面新建名为 py_demo 的文件夹)。
  2. 在文件夹内新建一个文本文档,并重命名为 hello.py(如果系统隐藏了扩展名,请先在资源管理器顶部菜单的“查看”中勾选“文件扩展名”,确保文件名不是 hello.py.txt)。
  3. 用文本编辑器(如 VS Code、Sublime Text,或系统自带的记事本)打开 hello.py,输入以下内容并保存:
# hello.py
print("Hello, World!")

2. 在终端中切换路径并执行脚本

保存文件后,打开终端,需要先使用 cd(Change Directory)命令进入该文件所在的目录。例如文件保存在 D:\py_demo:

cd /d D:\py_demo

若是 macOS 或 Linux 系统(假设保存在用户主目录下的 py_demo):

cd ~/py_demo

确认终端当前所在的路径已切换至代码文件夹后,输入执行命令:

python hello.py
预期执行输出结果: Hello, World!

回车后,终端输出了 Hello, World!,紧接着光标重新恢复为普通的命令行提示符。这表明 Python 解释器已经成功读取了 hello.py 脚本,逐行解析并执行了其中的指令,随后安全退出进程。到这一步,整个 Python 运行环境的验证便已完整达成。

Python安装后怎么验证成功并运行第一个Hello World程序
图 4:新手首次运行 Python 常见阻碍与精准处置策略速查
验证通过标志速览

当以下三项结果均已呈现,即可确认 Python 开发环境已在当前设备上配置完成:

  1. 在终端执行 python --version 或 python3 --version,能准确显示 3.x 版本号,且能通过 where python 定位安装路径;
  2. 在终端输入 python 进入带有 >>> 符号的交互界面,执行 print("Hello, World!") 能够即刻得到纯文本反馈,并通过 exit() 顺利退出;
  3. 在指定工作目录下新建 hello.py 脚本,经终端 python hello.py 调用后,输出结果一致且控制台正常交还光标。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。