Python新手怎么编写并运行第一个程序

江屿
江屿
发布时间:2026-11-13| 4人浏览过
原创

面向Python新手的实用起步教程,详细讲解如何确认环境、编写第一个hello.py脚本文件、通过命令行终端执行程序以及排查常见初学报错。

编写并运行第一个 Python 程序的完整路径非常清晰:先确认计算机上已就绪 Python 解释环境,接着使用纯文本或轻量代码编辑器创建一个以 .py 为后缀的代码文件,在其中写入一行标准的输出指令,最后打开命令行终端切换到该文件所在文件夹并执行调用。只要掌握了这套从“写文件”到“终端调用”的基础链路,就掌握了后续编写所有复杂程序的共同入口。

Python新手怎么编写并运行第一个程序
图 1:Python 新手编写并运行第一个程序的核心四步全流程

第一步:确认本地 Python 环境已安装

在开始写代码前,必须先确认计算机上已经成功配置好 Python 解释器。许多新手遇到的挫折并非代码写错,而是操作系统根本找不到 python 命令。

请按操作系统打开对应的终端工具:

  • Windows 用户:按下键盘上的 Win + R,在弹出窗口中输入 cmd 并回车,打开“命令提示符”;或在搜索栏中输入“PowerShell”。
  • macOS / Linux 用户:打开“聚焦搜索”(Cmd + 空格)输入“终端”(Terminal)并打开。

在光标后键入以下命令并按下回车:

python --version

如果系统正确输出了版本信息(例如 Python 3.10.12 或 Python 3.12.3),说明解释器已经可以正常使用。在某些 macOS 或 Linux 设备上,默认的 Python 3 可能关联在 python3 命令下,此时可以使用 python3 --version 进行验证。

注意:如果终端提示“'python' 不是内部或外部命令,也不是可运行的程序”或“command not found”,说明 Python 尚未安装,或者在安装时未勾选“Add python.exe to PATH”(将 Python 添加至系统环境变量)。此时需要重新运行官方安装包,勾选环境变量选项并完成修复。

第二步:两种运行方式与交互式模式初试

Python 提供了两种主要的代码运行方式:交互式命令行(REPL)与源码脚本文件(.py)。理解两者的区别,有助于消除对“写代码到底写在哪里”的困惑。

Python新手怎么编写并运行第一个程序
图 2:Python 交互式解释器 (REPL) 与脚本文件 (.py) 运行模式对比

在终端直接输入 python 并回车,终端提示符会变成三个大于号 >>>。这表示已进入交互式环境。此时输入:

print("Hello, World!")

按下回车后,下一行立即输出了 Hello, World!。想要退出这个交互环境,输入 exit() 并按回车即可回到系统命令行终端。

交互式环境适合做一两行代码的临时验证。但正式编写软件时,必须把代码存为独立文件,这就是下一步要做的标准工作。

第三步:编写第一个 .py 脚本文件

编写 Python 源代码只需要能保存纯文本的工具。建议新手使用轻量代码编辑器(如 VS Code、Sublime Text,或操作系统自带的记事本),切忌使用 Word、WPS 等富文本办公软件,因为富文本软件会向文件写入不可见的排版标记,导致 Python 无法识别代码。

1. 创建项目文件夹与代码文件

在电脑容易找到的路径(例如桌面或 D:\python_project,macOS 用户的 ~/Documents/python_project)下新建一个普通文件夹,命名为 hello_python。

在文件夹内新建一个文本文件,命名为 hello.py。注意文件扩展名必须是小写的 .py。如果使用的是 Windows 系统,请确保在资源管理器中勾选了“文件扩展名”,避免误将文件存为 hello.py.txt。

2. 输入标准打印代码

用编辑器打开 hello.py,在第一行写入以下代码并保存:

print("Hello, World!")
print("欢迎学习 Python 编程!")

这里的语法规则十分直接:

  • print() 是 Python 提供的内置输出函数,负责将圆括号内的内容展示到终端屏幕上。
  • 双引号 "..." 用来界定字符串文本。成对的单引号 '...' 具有相同的效果。
  • 括号和引号都必须在英文半角状态下输入。输入中文字符的逗号、括号或引号会导致语法解析失败。

第四步:在终端中定位并运行程序

文件编写完成后,必须通过终端找到该文件并指示 Python 解释器执行它。

1. 定位到文件所在的目录

打开终端后,终端的当前工作路径默认在用户主目录。如果直接执行 python hello.py,终端会提示找不到文件。因此需要先用 cd(Change Directory)命令切入目标文件夹:

# 以 Windows 桌面路径为例
cd C:\Users\你的用户名\Desktop\hello_python

# 以 macOS / Linux 路径为例
cd ~/Documents/hello_python

如果不熟悉敲击路径,可以在终端先输入 cd (注意 cd 后面有一个空格),然后直接用鼠标将文件夹从桌面拖拽到终端窗口中,终端会自动补全完整路径,按下回车即可。

2. 输入执行指令

确认终端提示符当前所在文件夹正确后,输入以下命令并回车:

python hello.py

此时终端屏幕会逐行输出文件中的打印结果:

Hello, World!
欢迎学习 Python 编程!

当看到这两行文本清晰显示出来时,代表第一个完整 Python 脚本编写并运行成功。

第五步:新手常见运行报错与排查清单

在第一次运行代码时遇到报错非常正常。Python 解释器的报错信息会指明出错的行号与原因,读懂这些提示能迅速定位问题。

Python新手怎么编写并运行第一个程序
图 3:初次运行 Python 程序的三类高频报错与对应排查策略

遇到报错时无需慌张,按照以下顺序对照检查:

  1. 检查符号中英文状态:中文括号 () 和中文双引号 “” 与英文字符 ()、"" 在视觉上非常相似,但解释器仅支持半角英文符号。
  2. 检查大小写规范:Python 对大小写高度敏感,Print()、PRINT() 均无法被系统识别,必须全部保持小写 print()。
  3. 检查当前目录与同名文件:如果在命令行执行 python hello.py 报 can't open file 'hello.py': [Errno 2] No such file or directory,可以在终端输入 dir(Windows)或 ls(macOS/Linux)列出当前目录下的所有文件,核验目标文件是否存在于列表中。

第六步:Python 程序的执行机制简析

了解代码在敲下命令后是如何在系统底层流转的,能让编写代码的过程变得更加清晰透彻。

当你输入 python hello.py 后,计算机并非直接将文字送进 CPU 执行,而是经历了编译与虚拟机解释的过程:

Python新手怎么编写并运行第一个程序
图 4:Python 代码从文本源文件到虚拟机执行与终端输出的完整生命周期

首先,Python 解释器读取你的 hello.py 文本文件,对其中的字符进行词法与语法分析;一旦发现不合规的标点或拼写,便会在这个阶段阻断并抛出 SyntaxError。在语法合规的前提下,解释器会将其编译为平台无关的字节码(Bytecode)。最后,Python 虚拟机(PVM)负责逐条读取这些字节码,翻译为操作系统能够直接执行的指令,将字符最终呈现在操作系统的标准输出终端上。

总结与进阶练习建议

编写与运行第一个 Python 程序的核心步骤可以归纳为:“建文件、写代码、进目录、敲命令”。在熟练掌握上述流程后,可以尝试以下两项微型拓展练习,巩固对基础代码的控制力:

  • 增加变量打印:在 hello.py 中定义变量 name = "Python",然后尝试执行 print("欢迎学习", name),观察逗号隔开不同元素时的输出效果。
  • 尝试简单数学运算:写入 print(10 + 20),观察不加引号的数字与带引号的文本在输出时的异同。

只要保持对标点符号规范、工作目录路径以及终端提示信息的严谨态度,Python 的学习之旅就已经迈出了最扎实的第一步。

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

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 算法库。