如何在 Windows、macOS 和 Linux 上下载并安装 Python:分步说明
可以从官网 python.org 的 Downloads 页面免费下载 Python,也可以用 uv 一条命令安装:uv python install 3.15。Windows 安装时勾选 Add python.exe to PATH;macOS 使用 python.org 的 .pkg 安装包或 Homebrew;Linux 使用发行版的包管理器或 uv。安装后用 python3 --version 检查版本。
Python 可以从官方网站 python.org 免费下载,也可以用 uv 一条命令安装。下面是 Windows、macOS 和 Linux 的分步安装说明,包括版本检查、交互式控制台 REPL、IDLE 环境以及第一个脚本。整个过程大约需要十分钟。
在哪里免费、安全地下载 Python
Python 是自由软件,不需要付费。官方来源只有一个:python.org 网站的 Downloads 页面。那里提供 Windows 和 macOS 的安装程序,以及用于自行编译的源代码。来路不明的“Python 精简版”或第三方打包版最好不要使用,因为你无法确定里面被加入了什么。
第二种方式是 Astral 公司开发的 uv 管理器,现在越来越多的项目选择它。这是一个程序,可以下载所需版本的 Python、创建虚拟环境并安装库。它可以替代 pyenv、pip、venv、pipx 和 poetry 的组合,并且不会改动系统自带的 Python。
| 方式 | 优点 | 适合谁 |
|---|---|---|
| python.org 安装程序 | 官方版本,自带 IDLE 和文档 | Windows 和 macOS 新手 |
| uv | 一条命令安装任意版本,每个项目有独立环境,不影响系统 | 所有人,尤其是 Linux 用户和同时维护多个项目的人 |
| 操作系统包管理器(apt、dnf、brew) | 熟悉,并随系统一起更新 | 仓库中的版本够用时 |
应该选择哪个 Python 版本
请安装最新的稳定版 Python 3。新版本每年十月发布,写这篇文章时最新的是 Python 3.15。Python 2 分支早已停止维护,那些写着 print "hello"(不带括号)的教程已经过时了。
“选个老一点的版本,它更成熟”其实是个陷阱:到 2026 年 10 月,Python 3.10 已经不再接收包括安全修复在内的任何更新。为 3.15 编写的代码不一定能在旧版本上运行,而 Python 3 系列内部的向后兼容性很好,通常最新版本就是最佳选择。
在 Windows 上安装 Python
通过 python.org 的安装程序
- 打开 python.org,进入 Downloads 页面,下载 Windows 安装程序(64 位版本几乎适用于所有电脑)。
- 运行安装文件。在第一个窗口中一定要勾选 Add python.exe to PATH,否则终端里找不到
python命令。 - 点击 Install Now,等待安装完成。
- 打开一个新的 PowerShell 或命令提示符窗口,检查版本。
PS C:\Users\anna> python --version
Python 3.15.0
PS C:\Users\anna> py --list
-V:3.15 * Python 3.15 (64-bit)
命令 py 是 Windows 上的 Python 启动器:它能识别所有已安装的版本,并能运行指定的版本,例如 py -3.15 script.py。在较新的版本中,python.org 也为 Windows 提供了新的 Python 安装管理器(Python install manager);如果你在下载页面上看到它,按提示操作即可,原理相同。
通过 PowerShell 安装 Python
在 Windows 10 和 Windows 11 上,也可以不打开浏览器,直接用 uv 安装 Python。先用官方脚本安装 uv,然后安装所需版本:
PS> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
PS> uv python install 3.15
PS> uv run --python 3.15 python --version
Python 3.15.0
另一种选择是系统包管理器 winget:winget search Python.Python 会列出可用的版本,然后用 winget install 加上找到的标识符即可安装所选版本。
常见问题:打开的是 Microsoft Store
如果你输入 python,结果打开的是 Microsoft Store 而不是解释器,说明 Python 没有加入 PATH,触发了 Windows 的占位程序。请重新安装 Python 并勾选 Add python.exe to PATH,或者在“设置 → 应用 → 应用执行别名”中关闭这些占位程序。修改 PATH 之后,一定要打开新的终端窗口。
在 macOS 上安装 Python
在 macOS 上,python3 命令可能已经存在,它可能是系统版本,也可能是 Xcode 命令行工具的占位程序,而且通常版本较旧。学习用途的话,请用以下任一方式安装最新版本:
- python.org 的安装包 — 下载适用于 macOS 的安装文件(
.pkg,同时支持 Intel 和 Apple Silicon 芯片),然后按照向导完成安装。安装过程中会一并装上 IDLE。 - Homebrew — 如果你已经装了它:
brew install python。 - uv — 使用官方安装脚本,然后安装指定版本。
$ curl -LsSf https://astral.sh/uv/install.sh | sh
$ uv python install 3.15
$ uv run --python 3.15 python --version
Python 3.15.0
在 macOS 和 Linux 上请使用 python3 命令:那里的 python 可能不存在,或者指向另一个程序。
在 Linux 上安装 Python:Ubuntu、Debian 等
在 Linux 上通常已经预装了 Python,但它是系统解释器:操作系统自身的工具依赖它,版本一般落后几年。Ubuntu 24.04 自带 Python 3.12,Debian 12 自带 3.11。不要升级或删除系统 Python,否则可能破坏包管理器。
如果仓库中的版本足够用,请连同虚拟环境模块和 pip 一起安装:
$ sudo apt update
$ sudo apt install python3 python3-venv python3-pip
$ python3 --version
Python 3.12.3
在 Fedora 和 RHEL 系列系统上,sudo dnf install python3 可以完成同样的事情。如果需要比系统版本更新的 Python,最方便的是 uv:它把解释器放在你的主目录中,不会改动任何系统文件。
$ curl -LsSf https://astral.sh/uv/install.sh | sh
$ uv python install 3.15
$ uv python find 3.15
/home/lena/.local/share/uv/python/cpython-3.15.0/bin/python3.15
为什么不要执行 sudo pip install
用 sudo pip install 把库装进系统 Python,是通往损坏 apt 的最短路径。因此,根据 PEP 668,现代发行版会以 externally-managed-environment 错误阻止这种安装。正确的做法是为项目创建虚拟环境,下面会详细说明。
如何检查 Python 是否安装成功
安装完成后,打开一个新的终端并执行检查。不同系统的命令如下:
| 任务 | Windows | macOS / Linux |
|---|---|---|
| Python 版本 | python --version 或 py --version | python3 --version |
| 解释器位置 | where python | which python3 |
| pip 版本 | py -m pip --version | python3 -m pip --version |
| 在 Python 内部查看版本 | import sys; print(sys.version) | import sys; print(sys.version) |
“python” 和 “python3” 是不同的程序
第一天常见的情况是:有人安装了最新的 Python,编写了使用新特性的代码,结果得到 SyntaxError。原因是终端调用的是旧版本——同一台机器上可能装了三四个版本。用 which python3(Windows 上是 where python)检查路径,并在项目中用 uv run 运行代码,它总是使用项目指定的版本。
如何更新 Python
Python 不能在大版本之间“原地”升级:3.14 和 3.15 作为不同的程序并存。要更新 Python,请用同样的方式安装新版本——通过 python.org 的安装程序、brew upgrade python,或 uv python install 3.15——然后在新版本上重新创建项目的虚拟环境。同一版本内的修复(如 3.15.0 → 3.15.1),python.org 的安装程序会直接覆盖安装在旧版本之上。
REPL:Python 交互式控制台
体验 Python 最快的方式是交互式控制台,即 REPL(Read–Eval–Print Loop:读取、执行、输出、循环)。不带文件名启动解释器,它会显示提示符 >>>:
$ python3
Python 3.15.0 ...
>>> 2 + 3
5
>>> name = "咖啡"
>>> name.upper()
'咖啡'
>>> exit
退出可以输入 exit,或按 Ctrl+D(Windows 上是 Ctrl+Z,然后按 Enter)。从 3.13 版本开始,控制台明显更好用:提示符和 traceback 带有颜色,可以整块编辑多行代码,F1 显示帮助,F2 查看历史,F3 进入粘贴模式,而 exit 和 quit 不加括号也能用。3.14 增加了输入时的代码高亮,以及在 import 后按 Tab 补全模块名。若想恢复简单的控制台,可以设置环境变量 PYTHON_BASIC_REPL=1。
IDLE:自带的简单开发环境
python.org 为 Windows 和 macOS 提供的安装程序会附带 IDLE——一个带控制台的小型编辑器。在“开始”菜单或“程序”中找到它(文件夹 Python 3.15)。IDLE 有两个窗口:Shell 就是同样的 >>> 控制台;另外是文件编辑器:File → New File,写好代码,保存,然后按 F5(Run → Run Module)运行。在 Linux 上,IDLE 通常作为单独的包安装,在 Debian 和 Ubuntu 上是 sudo apt install idle3。
学习最初几周,IDLE 完全够用。项目变大以后,可以换成功能更全面的编辑器,例如 VS Code 或 PyCharm,但解释器仍然是同一个。
第一个 Python 脚本
控制台适合试验,但正式的程序写在文件中。脚本就是一个扩展名为 .py 的普通文本文件,解释器会从上到下逐行执行。创建文件 expenses.py:
item = "咖啡"
amount = 250
print(item, amount)
在文件所在的文件夹中运行它:
$ python3 expenses.py
咖啡 250
在 Windows 上命令是 python expenses.py 或 py expenses.py,使用 uv 则是 uv run expenses.py。如果看到 can't open file,说明你不在正确的文件夹里:用 cd 切换过去即可。
带虚拟环境的项目
虚拟环境是一个独立的文件夹 .venv,里面有自己的 Python 和库,这样一个项目的依赖不会干扰其他项目。使用 uv 时,一条命令就能创建项目:
$ uv init expenses --python 3.15
Initialized project `expenses`
$ cd expenses && ls -a
.python-version README.md main.py pyproject.toml
$ uv run main.py
Hello from expenses!
pyproject.toml 是项目的“身份证”,.python-version 记录了版本,而 .venv 会在首次运行时由 uv 创建。不使用 uv 时,用标准模块创建环境:python3 -m venv .venv,然后激活 source .venv/bin/activate(Windows 上是 .venv\Scripts\activate),再用 pip install 安装库。
安装 Python 时的常见错误
| 现象 | 原因 | 解决办法 |
|---|---|---|
Windows 上出现 'python' is not recognized | Python 没有加入 PATH | 重新安装并勾选 Add python.exe to PATH,或改用 py 运行 |
Linux 上出现 python3: command not found | 没有安装 Python(最小化镜像、容器) | sudo apt install python3,或使用 uv |
No module named pip | 安装 Python 时没有带上 pip | python3 -m ensurepip --upgrade,或安装 python3-pip 包 |
externally-managed-environment | 尝试把库装进系统 Python(PEP 668) | 创建虚拟环境,并把包安装到其中 |
| 安装后版本还是旧的 | 终端是在安装前打开的,或 PATH 中排在前面的是另一个 Python | 打开新的终端,用 which python3 或 where python 检查 |
几乎所有安装问题都归结为两点:PATH 设置和多个版本之间的混淆。如果不确定当前使用的是哪个解释器,运行 python3 -c "import sys; print(sys.executable)",命令会打印它的完整路径。
小结
最安全的 Python 下载方式是 python.org 或 uv;在 Windows 上别忘了勾选 PATH,在 Linux 上不要动系统解释器。安装完成后,检查版本,试一下 REPL 和 IDLE,运行第一个脚本——然后就可以学习变量、字符串和条件了。Python 3.15 的安装、控制台的使用以及用 uv 创建第一个项目,都会在课程的第一讲中实际演示。
常见问题
Python 收费吗?
不收费。Python 是免费的,采用自由的 PSF 许可证,也可以用于商业项目。
安装新版本之前需要删除旧版本吗?
不需要,不同版本可以同时存在。在 Linux 和 macOS 上绝对不能删除系统自带的 Python,操作系统的工具依赖它。
没有管理员权限能安装 Python 吗?
可以。在 Windows 上,python.org 的安装程序可以只为当前用户安装 Python;uv 则始终把解释器放在主目录中。
输入 python 提示找不到命令,怎么办?
说明 Python 没有加入 PATH。请重新安装并勾选 Add python.exe to PATH,或在 Windows 上用 py 运行,在 macOS 和 Linux 上用 python3,然后打开新的终端。
Python 占用多少空间?
解释器加上标准库大约需要一百兆字节左右;之后占空间的主要是虚拟环境中安装的库。