- 环境准备:确保你的电脑可以运行 Python 代码。
- 编写代码:使用 Notepad 创建并保存你的第一个 Python 程序。
- 运行与调试:执行代码并排查错误。
第 1 步:环境准备 - 安装 Python
记事本只是一个纯文本编辑器,它本身不能运行代码,你需要一个叫做 Python 解释器 的程序来读取和执行你写的代码。

-
下载 Python:
- 打开浏览器,访问 Python 官方网站:https://www.python.org/downloads/
- 网站会自动检测你的操作系统并提供最新的稳定版下载,点击 "Download Python X.X.X" 按钮。
-
安装 Python (关键步骤):
- 找到你下载的
.exe文件并双击运行。 - 在安装界面,请务必勾选 "Add Python X.X to PATH" 这个选项! 这一步非常重要,它能让你在电脑的任何位置轻松运行 Python。
- 勾选后,点击 "Install Now" 进行标准安装。
- 安装完成后,点击 "Close"。
- 找到你下载的
-
验证安装:
- 按
Win + R键,输入cmd并回车,打开命令提示符。 - 在命令提示符窗口中输入
python --version然后按回车。 - 如果显示出版本号(
Python 3.11.4),说明安装成功!你已经准备好开始编程了。
- 按
第 2 步:使用 Notepad 编写 Python 代码
现在我们用记事本来写一个简单的 "Hello, World!" 程序。

-
打开记事本:
在开始菜单中搜索 "记事本" (Notepad) 并打开它。
-
编写代码:
- 在记事本的空白处输入以下代码:
# 这是一个简单的 Python 程序 print("Hello, World!") name = "Python 初学者" print(f"欢迎你, {name}!")
- 在记事本的空白处输入以下代码:
-
保存文件 (至关重要!):
- 点击记事本左上角的 "文件" -> "另存为"。
- 在弹出的窗口中:
- 保存位置:选择一个你容易找到的地方,比如桌面。
- 文件名:这是最关键的一步!文件名必须以
.py例如hello.py。不要省略.py后缀! - 保存类型:选择 "所有文件(*.*)",这一步可以防止记事本自动给你的文件加上
.txt后缀。
- 点击 "保存"。
恭喜!你已经成功创建了你的第一个 Python 文件。
第 3 步:运行与调试代码
代码写好了,现在需要运行它并看看结果,调试的核心就是找到并修复错误。
通过命令提示符运行
这是最标准、最推荐的方法,因为它能让你看到完整的输出和错误信息。
-
打开命令提示符:
- 按
Win + R键,输入cmd并回车。
- 按
-
切换到文件所在目录:
- 假设你把
hello.py保存在桌面,你需要先进入桌面目录,在命令提示符中输入:cd Desktop
注意:如果你的用户名是中文,桌面路径可能是
cd C:\Users\你的用户名\Desktop - 按
Enter键。
- 假设你把
-
运行 Python 文件:
- 在命令提示符中,输入
python后面跟着你的文件名,然后按回车:python hello.py
- 如果一切顺利,你会在窗口中看到程序的输出:
Hello, World! 欢迎你, Python 初学者!
- 在命令提示符中,输入
如何调试?(遇到错误时怎么办)
当你写的代码有语法或逻辑错误时,Python 解释器会报错,调试就是读懂这些错误信息并修复它们。
语法错误
假设你在记事本中不小心写错了代码,比如漏掉了冒号:
# 错误的代码
print("Hello, World") # 少了一个冒号
name = "Python 初学者"
print(f"欢迎你, {name}!")
-
保存这个错误的文件(
error.py)。 -
在命令提示符中运行它:
python error.py
-
查看错误信息: 你会看到类似下面的内容:
File "C:\Users\YourUser\Desktop\error.py", line 2 print("Hello, World") # 少了一个冒号 ^ SyntaxError: EOL while scanning string literalFile "...error.py", line 2: 告诉你错误发生在error.py文件的第 2 行。print("Hello, World") ...: 显示出错的代码行。^: 这个箭头精确地指出了错误发生的位置。SyntaxError: EOL while scanning string literal: 这是错误类型和描述。SyntaxError表示语法错误,意思是 Python 不明白你写的这句话。
如何修复:
根据错误信息,回到记事本,打开 error.py 文件,在第 2 行末尾加上冒号 ,然后保存,再次运行即可。
逻辑错误
有时候代码没有语法错误,能运行,但结果不是你想要的。
假设你想要计算 10 + 20,但写错了:
# 逻辑错误的代码
result = 10 * 20 # 错误地用了乘法
print(f"10 + 20 的结果是: {result}")
-
保存并运行这个文件:
python logic_error.py
-
查看输出: 程序会正常执行,但输出是错误的:
10 + 20 的结果是: 200程序没有崩溃,Python 不会给你任何错误提示,这就是逻辑错误。
如何修复:
这种错误不能靠 Python 提示,需要你自己通过阅读代码、思考逻辑、使用 print() 语句来排查。
-
方法:增加
print()语句,你可以在关键步骤后面加上print()来查看变量的值。a = 10 b = 20 print(f"a 的值是: {a}, b 的值是: {b}") # 查看初始值 result = a * b # 怀疑这里有问题 print(f"计算后的 result 值是: {result}") # 查看计算结果 print(f"10 + 20 的结果是: {result}")运行后,你会清晰地看到每一步的值,从而发现问题所在,然后把 改成 即可。
更好的工具:从 Notepad 升级
虽然可以用记事本,但对于稍微复杂一点的程序,它非常不方便,因为它没有:
- 语法高亮:不同颜色的代码让你更容易阅读。
- 代码自动补全:提高输入速度。
- 更强大的调试工具:可以设置断点、单步执行等。
当你熟悉了基本流程后,强烈建议你使用一个专门的代码编辑器,它们都免费且强大:
-
Visual Studio Code (VS Code):
- 目前最受欢迎的免费代码编辑器。
- 安装后,在扩展商店中搜索 "Python",安装官方 Python 插件。
- 安装后,你将获得语法高亮、智能代码补全、一个集成的终端(可以直接在 VS Code 里运行命令)和强大的调试器。
-
PyCharm Community Edition (PyCharm 社区版):
- 专门为 Python 开发的 IDE(集成开发环境)。
- 功能非常强大,调试工具尤其出色,非常适合初学者和专业人士。
| 步骤 | 工具/操作 | 目的 |
|---|---|---|
| 准备 | 安装 Python 解释器 (勾选 Add to PATH) | 让电脑能执行 Python 代码 |
| 编写 | 用 Notepad 写代码,保存为 .py 文件 |
创建源代码文件 |
| 运行 | 在命令提示符中使用 python 文件名.py |
执行代码,查看正确输出 |
| 调试 | 语法错误:阅读错误信息,定位到文件和行号。 逻辑错误:使用 print() 语句打印中间变量值。 |
找出并修复代码中的问题 |
从记事本开始学习,能让你对 Python 代码的执行过程有更清晰的认识,当你需要更高效的开发体验时,再转向 VS Code 或 PyCharm 这样的专业工具,祝你学习愉快!
