教程

如何在 Windows、macOS 和 Linux 上下载并安装 Python:分步说明

更新于: · Skillaria.Top

可以从官网 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 的安装程序

  1. 打开 python.org,进入 Downloads 页面,下载 Windows 安装程序(64 位版本几乎适用于所有电脑)。
  2. 运行安装文件。在第一个窗口中一定要勾选 Add python.exe to PATH,否则终端里找不到 python 命令。
  3. 点击 Install Now,等待安装完成。
  4. 打开一个新的 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 是否安装成功

安装完成后,打开一个新的终端并执行检查。不同系统的命令如下:

任务WindowsmacOS / Linux
Python 版本python --version 或 py --versionpython3 --version
解释器位置where pythonwhich python3
pip 版本py -m pip --versionpython3 -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 recognizedPython 没有加入 PATH重新安装并勾选 Add python.exe to PATH,或改用 py 运行
Linux 上出现 python3: command not found没有安装 Python(最小化镜像、容器)sudo apt install python3,或使用 uv
No module named pip安装 Python 时没有带上 pippython3 -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 占用多少空间?

解释器加上标准库大约需要一百兆字节左右;之后占空间的主要是虚拟环境中安装的库。

通过视频学习本主题

课程“Python 3.15: от новичка до профи”结合实践详细讲解了这一主题。

前往课程