# 第一行代码：装好 Python，看到它真的跑起来

零基础第一次动手：装解释器、认识 IDLE、写下 print 并跑起来，同时拆掉新手必踩的三个坑。

> Python 环境安装 · 第一个程序 · 约 6 分钟 · 09 月 09 日

## 本篇要点

1. 你写的 .py 只是文本，真正执行它的是解释器；运行程序，就是请解释器把文件从头到尾读一遍、执行一遍。
2. Windows 安装时务必勾选 `Add python.exe to PATH`——PATH 是系统找命令的通讯录；装完用 `python --version` 验证，没勾会报“不是内部或外部命令”，重装勾上或改用 `py` 命令。
3. macOS 终端命令是 `python3` 而不是 `python`；系统自带一份苹果专用的旧版 python3，与 python.org 新装的可共存且新装的优先，别去动系统那份。
4. print 是程序唯一的“嘴”，作用是把括号里的内容显示到屏幕上；第一份文件用 IDLE 写好，按 F5（Run → Run Module）运行，输出出现在 Shell 窗口。
5. 双击 .py 黑窗一闪而过不是坏了，是程序跑完、窗口自动关闭；要用 IDLE 或终端运行才能留住输出。
6. 文件被存成 hello.py.txt、改了代码忘了保存就运行，是另外两个高频坑；固定节奏是“改 → 保存 → 运行 → 看输出”。

---

上一篇结尾答应你的事，今天兑现：装好环境，写出第一行真正会运行的程序。这一篇走完“写 → 存 → 跑 → 看到输出”的完整闭环，顺便把新手几乎人人都会踩的三个坑一次讲明白。动手前，先补一个上一篇没来得及介绍的关键角色：解释器。

## 先认识解释器：真正跑代码的是它

你写下的 Python 代码，本质上只是普通文本，和写给同事的便条没有区别。电脑的处理器不读中文，也不读 Python，它只执行机器指令。中间需要一个“翻译兼执行者”：Python 解释器（interpreter）。它的工作方式，是把文件里的代码从头到尾一行一行读进来，翻译成电脑能执行的指令，然后立刻执行。

可以把它想成乐谱和演奏者的关系：你写的 `.py` 文件是乐谱，解释器是演奏者，“运行程序”就是请演奏者把整份乐谱从头演奏一遍。乐谱本身永远不会自己响起来——记住这句话，今天后面要讲的三个坑都跟它有关。

所以“安装 Python”真正装的是什么？就是这套解释器，外加 IDLE 等几个配套工具。下面分系统说。

## Windows：安装时记得勾选 `Add python.exe to PATH`

打开 python.org/downloads，下载 Windows 版安装包，双击运行。安装界面里如果出现 `Add python.exe to PATH` 这一项，务必勾上 [1]。

PATH 是什么？可以把它想成系统找命令时翻的通讯录。勾上它，等于把 Python 的地址写进通讯录，之后你在任何文件夹打开命令行，敲 `python` 都能被找到；不勾，系统就“查无此人”，敲 `python` 会报“不是内部或外部命令”——这是新手最常见的报错之一 [1]。如果装完才发现没勾，最简单的修复是重装一遍、这次勾上；Windows 上还有一个备选命令 `py`，官方文档把它作为多版本并存时更稳妥的用法 [1]。

装完验证一下：按 Win+R，输入 `cmd` 回车，在黑色窗口里敲 `python --version`，看到类似 `Python 3.13.x` 的字样就成了。开始菜单里搜 IDLE，也能找到随安装附带的它。

## macOS：命令是 python3，不叫 python

同样去 python.org 下载 macOS 安装包（`.pkg` 文件），双击按提示安装。装完后“应用程序”里会出现一个 Python 3.x 文件夹，IDLE 就在里面；官方还建议双击文件夹里的 `Install Certificates.command`，补一次证书安装 [2]。

然后打开“终端”，敲 `python3 --version`，看到版本号即成功。注意命令是 `python3`，不是 `python`，这是 Mac 与 Windows 最大的区别。原因不难懂：macOS 系统里本来就有一个给苹果自家开发工具用的 `python3`，装在 /usr/bin 下、版本偏旧且不完整，苹果明确告诫用户不要修改或删除它 [2]；你从 python.org 新装的那份会默认排在前面、优先被使用。你不用深究这套并存关系，只要记住一条：Mac 上敲命令一律用 `python3`，Windows 上敲 `python`，两边都不会错。

## 第一行代码：用 IDLE 写下并运行

IDLE 是官方安装包自带的简易编程环境 [2]，它包含两个角色：一个叫 Shell，就是带 `>>>` 提示符的窗口，你敲一行、它立刻执行一行，适合试验；另一个是编辑器，用来写完整的一份代码文件。

先在 Shell 里热个身：在 `>>>` 后面输入

```python
print("你好，Python！")
```

按回车，屏幕上立刻原样显示“你好，Python！”。print 的中文意思是“打印”，作用是把括号里的内容显示到屏幕上——它是程序唯一一张“嘴”。程序看不见摸不着，想让你知道它干了什么，全靠 print 把话说出来。

但一行一行闲聊不算程序，正经的程序是一份文件。点击 IDLE 菜单 File → New File 打开编辑窗口，输入两行：

```python
print("你好，Python！")
print("我的第一份程序文件跑起来了。")
```

然后按 F5（或菜单 Run → Run Module），IDLE 会先让你保存文件，把它命名为 `hello.py` [3]。保存后回到 Shell 窗口，你会看到两行输出，顺序和代码里写的完全一致——这正是上一篇说的“从上到下逐行执行”，此刻你亲眼验证了它。恭喜，这是你写下的第一份真正会运行的程序。

## 换个方式再跑一次：终端里的 python hello.py

你大概已经察觉，F5 的本质就是“请解释器把这份文件从头执行一遍”。以后写改文件名、合并报表的脚本，还有另一种常用跑法：在终端里敲一条命令。现在就用终端把这份文件再跑一次，为后面铺路。

Windows：打开文件资源管理器，进入 `hello.py` 所在文件夹，在地址栏输入 `cmd` 回车，会直接打开一个停在该文件夹的命令行窗口，敲 `python hello.py`。macOS：打开“终端”，输入 `cd` 加一个空格，把 `hello.py` 所在文件夹拖进窗口再回车，然后敲 `python3 hello.py`。两边都应该看到与刚才相同的输出。

到这里，你对 `.py` 应该有了实感：它就是一个约定俗成的文本文件，后缀提醒系统“这是 Python 代码”。用记事本也能写，但保存时必须存成 `.py`，而不是 `.txt`。

## 三个新手坑，根源都是同一件事

**双击 `hello.py`，黑色窗口一闪而过。** 别慌，程序其实从头到尾跑完了，输出也出现过——只是程序一结束，系统就把窗口关掉了。这不是没装好，而是程序“跑完就退出”的本性。所以别用双击的方式运行，回到 IDLE 按 F5，或在终端里运行，窗口会留在原地让你看输出。

**敲 `python hello.py` 却报找不到文件，一看文件名原来是 `hello.py.txt`。** Windows 默认隐藏“已知类型文件”的扩展名，记事本保存时又悄悄补上 `.txt`，于是你看着是 `hello.py`，真名其实是 `hello.py.txt`，解释器按你说的名字去找，自然扑空。解决：在文件资源管理器的“查看”菜单里勾选“文件扩展名”，保存时把文件类型选成“所有文件”。

**在 IDLE 里改了代码，运行出来却还是旧结果。** 多半是忘了保存，或者忘了重新运行。写代码不等于生效，改完必须存盘，再请解释器重新读一遍。从今天起你的日常就是这个循环：改 → 按 Ctrl+S 存 → 运行 → 看输出 → 再改，它会陪你很久很久。

今天这条线走通了：写、存、跑、看到输出，一个最小但完整的闭环。你的电脑从此真的会“执行”你写的规则了。下一站，让程序学会“记住”东西——那是变量，也是它替你接手那 80 个混乱文件名的第一步。

## 来源

1. [Python 官方 Windows 使用文档：PATH 选项的作用、python 与 py 命令、常见故障排查](https://docs.python.org/3/using/windows.html)
2. [Python 官方 macOS 使用文档：python.org 安装包内容、IDLE、系统自带 python3 与新版共存的关系](https://docs.python.org/3/using/mac.html)
3. [Python 官方 IDLE 文档：Run → Run Module（F5）的执行方式与输出显示规则](https://docs.python.org/3/library/idle.html)
4. [Python 官方下载页：Windows 与 macOS 安装包入口](https://www.python.org/downloads/)

---

原文：https://pangzhengboyin.com/articles/install-python-run-first-program-38c3a773

> **庞征博引** · 想学的，慢慢都会
>
> 庞征博引是把想学的东西写成连载的 AI 学习工具。说出想学什么，它会先了解你的基础，再把主题写成一篇篇 5–10 分钟能读完的文章；边读边问，接下来学什么跟着你走。这篇就是这样写出来的。
>
> 开始你自己的连载 → https://pangzhengboyin.com